O utilitário CURL é uma ferramenta de linha de comando disponível no Unix, Linux, Mac OS X, Windows e muitas outras plataformas. ¿ Como operar em CouchDB usando CURL ?
O CURL fornece acesso fácil ao protocolo HTTP (entre outros) diretamente da linha de comando e, portanto, é uma maneira ideal de interagir com o CouchDB por meio da API REST HTTP.
Como executar operações no CouchDB usando CURL?
Para solicitações GET simples, você pode fornecer o URL da solicitação. Por exemplo, para obter as informações do banco de dados: shell> curl http://127.0.0.1:5984
- Isso retorna as informações do banco de dados:
{
"couchdb": "Bem-vindo",
"version": "2.0.0",
"vendedor": {
"name": "Apache Software Foundation"
}
}Para alguns URLs, especialmente aqueles que incluem caracteres especiais, como um sinal comercial, um ponto de exclamação ou um ponto de interrogação.
Você deve inserir o URL que está especificando na linha de comando. Por exemplo: shell> curl ‘http: // couchdb: 5984 / _uuids? count = 5 ‘
No Microsoft Windows, use aspas duplas em qualquer lugar que você veja aspas simples nos exemplos a seguir. Use aspas duplas (“”) em qualquer lugar que veja aspas simples. Por exemplo, se você vir:
shell> curl -X PUT 'http: /127.0.0.1: 5984 / demo / doc' -d '{"lema": "Eu amo pôneis"}'- Você deve substituí-lo por:
shell> curl -X PUT “http://127.0.0.1:5984/demo/doc” -d “{” “lema” “:” “Eu amo ponyss” “}”
Se você preferir, pode usar ^ “e ”Para escapar do caractere de aspas duplas nas aspas.
Você pode definir explicitamente o comando HTTP usando a opção de linha de comando -X . Por exemplo, ao criar um banco de dados, você define o nome do banco de dados na URL que envia usando uma solicitação PUT:
shell> curl -X PUT http://127.0.0.1:5984/demo
{"ok": verdadeiro}Mas, para obter as informações do banco de dados, use uma solicitação GET (com as informações de retorno formatadas para maior clareza):
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 determinadas operações, você deve especificar o tipo de conteúdo da solicitação, especificando o cabeçalho Content-Type usando a opção de linha de comando -H:
shell> curl -H 'Tipo de conteúdo: application / json' http://127.0.0.1:5984/_uuids
Você também pode enviar dados de “carga útil”, ou seja, dados no corpo da solicitação HTTP usando a opção -d . Isso é útil se você precisar enviar estruturas JSON .
Por exemplo, dados do documento, como parte da solicitação :
shell> curl -H 'Tipo de conteúdo: application / json'
-X POST http://127.0.0.1:5984/demo
-d '{"company": "Example, Inc."}'
{"ok": true, "id": "8843faaf0b831d364278331bc3001ocket",
"rev": "1-33b9fbce46930280dab37d672bbc8bb9"}No exemplo anterior, o argumento após a opção -d é o JSON do documento que queremos enviar.
O documento pode ser acessado usando o ID do documento gerado automaticamente que foi retornado.
shell> curl -X GET http://127.0.0.1:5984/demo/8843faaf0b831d364278331bc3001ocket
{"_id": "8843faaf0b831d364278331bc3001ocket",
"_rev": "1-33b9fbce46930280dab37d672bbc8bb9",
"company": "Example, Inc."}Os exemplos de API no Básico da API mostram o comando HTTP , a URL e qualquer informação de carga útil que deve ser enviada (e o valor de retorno esperado).
Todos esses exemplos podem ser reproduzidos usando CURL com os exemplos de linha de comando mostrados acima.
