Saltar al contenido

¿Cómo Hacer Operaciones en CouchDB con CURL?

4 junio, 2019

La utilidad CURL es una herramienta de línea de comandos disponible en Unix, Linux, Mac OS X , Windows y muchas otras plataformas. ¿Cómo Realizar Operaciones en CouchDB Utilizando CURL?

CURL proporciona un acceso fácil al protocolo HTTP (entre otros) directamente desde la línea de comandos y por lo tanto, es una forma ideal de interactuar con CouchDB a través de la API REST de HTTP.

¿Cómo Realizar Operaciones en CouchDB Utilizando CURL?

Para solicitudes GET simples, puede proporcionar la URL de la solicitud. Por ejemplo, para obtener la información de la base de datos: shell> curl http://127.0.0.1:5984

  • Esto devuelve la Información de la Base de Datos:
{
"couchdb": "Bienvenido",
"version": "2.0.0",
"vendedor": {
"name": "The Apache Software Foundation"
}
}

Para algunas URL, especialmente aquellas que incluyen caracteres especiales como un signo comercial, un signo de exclamación o un signo de interrogación.

Debe indicar la URL que está especificando en la línea de comandos. Por ejemplo: shell> curl ‘http: // couchdb: 5984 / _uuids? count = 5’

En Microsoft Windows, use comillas dobles en cualquier lugar que vea comillas simples en los siguientes ejemplos. Use comillas dobles (“”) en cualquier lugar donde vea comillas simples. Por ejemplo, si ves:

shell> curl -X PUT 'http: /127.0.0.1: 5984 / demo / doc' -d '{"lema": "Me encantan los ponys"}'
  • Debe Reemplazarlo con:

shell> curl -X PUT “http://127.0.0.1:5984/demo/doc” -d “{” “motto” “:” “Amo los ponyss” “}”
Si lo prefiere, se pueden usar ^ “y \” para escapar del carácter de comillas dobles en las cadenas entrecomilladas.

Puede establecer explícitamente el comando HTTP utilizando la opción de línea de comando -X. Por ejemplo, al crear una base de datos, establece el nombre de la base de datos en la URL que envía mediante una solicitud PUT:

shell> curl -X PUT http://127.0.0.1:5984/demo
{"ok": verdadero}

Pero para obtener la información de la base de datos utiliza una solicitud GET (con la información de devolución formateada para mayor claridad):

shell> curl -X GET http://127.0.0.1:5984/demo

{
"compact_running": false,
"doc_count": 0,
"db_name": "demo",
"purge_seq": 0,
"commit_update_seq": 0,
"doc_del_count": 0,
"disk_format_version": 5,
"update_seq": 0,
"instance_start_time": "0",
"disk_size": 79
}

Para ciertas operaciones, debe especificar el tipo de contenido de la solicitud, lo que hace especificando el encabezado Content-Type usando la opción de línea de comando -H:

shell> curl -H 'Content-Type: application / json' http://127.0.0.1:5984/_uuids

También puede enviar datos de “carga útil”, es decir, datos en el cuerpo de la solicitud HTTP utilizando la opción -d. Esto es útil si necesita enviar estructuras JSON.

Por ejemplo, datos de documentos, como parte de la solicitud:

shell> curl -H 'Content-Type: application / json' \
-X POST http://127.0.0.1:5984/demo \
-d '{"compañía": "Ejemplo, Inc."}'
{"ok": verdadero, "id": "8843faaf0b831d364278331bc3001ocket",
"rev": "1-33b9fbce46930280dab37d672bbc8bb9"}

En el ejemplo anterior, el argumento después de la opción -d es el JSON del documento que queremos enviar.

Se puede Acceder al Documento Utilizando el ID de Documento Generado Automáticamente que se Devolvió.

shell> curl -X GET http://127.0.0.1:5984/demo/8843faaf0b831d364278331bc3001ocket
{"_id": "8843faaf0b831d364278331bc3001ocket",
"_rev": "1-33b9fbce46930280dab37d672bbc8bb9",
"compañía": "Ejemplo, Inc."}

Los ejemplos de API en los Conceptos básicos de API muestran el comando HTTP, la URL y cualquier información de carga útil que deba enviarse (y el valor de retorno esperado).

Todos estos ejemplos se pueden reproducir utilizando CURL con los ejemplos de línea de comandos que se muestran arriba.

¿Nos das 5 estrellas? ?