CouchDB - HTTP API

使用HTTP请求标头,您可以与CouchDB进行通信.通过这些请求,我们可以从数据库中检索数据,以文档的形式将数据存储到数据库中,我们可以查看和格式化存储在数据库中的文档.

HTTP请求格式

在与数据库通信时,我们将使用不同的请求格式,如get,head,post,put,delete和copy.对于CouchDB中的所有操作,输入数据和输出数据结构将采用JavaScript Object Notation(JSON)对象的形式.

以下是用于的HTTP协议的不同请求格式与CouchDB沟通.

  • GET : 此格式用于获取特定项目.要获取不同的项目,您必须发送特定的网址模式.在使用此GET请求的CouchDB中,我们可以以JSON文档的形式获取静态项目,数据库文档和配置以及统计信息(在大多数情况下).

  • HEAD :  HEAD方法用于获取没有响应主体的GET请求的HTTP头.

  • POST : 发布请求用于上传数据.在使用POST请求的CouchDB中,您可以设置值,上传文档,设置文档值,还可以启动某些管理命令.

  • PUT : 使用PUT请求,您可以创建新对象,数据库,文档,视图和设计文档.

  • DELETE : 使用DELETE请求,您可以删除文档,视图和设计文档.

  • COPY : 使用COPY方法,您可以复制文档和对象.

HTTP请求标头

HTTP标头应该提供以获得正确的格式和编码.在将请求发送到CouchDB服务器时,您可以发送Http请求标头以及请求.以下是不同的Http请求标头.

  • Content-type : 此标头用于指定我们提供给服务器的数据的内容类型以及请求.大多数情况下,我们与请求一起发送的内容类型将是MIME类型或JSON(application/json).强烈建议在请求中使用Content-type.

  • 接受 : 此标头用于指定服务器,即客户端可以理解的数据类型列表,以便服务器使用这些数据类型发送其响应.通常在这里,您可以发送客户端接受的MIME数据类型列表,以冒号分隔.

    虽然不需要在CouchDB的查询中使用Accept,但强烈建议确保返回的数据可以由客户处理.

响应标题

这些是标题服务器发送的响应这些标题提供有关服务器作为回复发送的内容的信息.

  • 内容类型  : 去;此标头指定服务器返回的数据的MIME类型.对于大多数请求,返回的MIME类型为text/plain.

  • Cache-control : 此标头建议客户端处理服务器发送的信息. CouchDB主要返回必须重新生效,表示如果可能,应重新验证信息.

  • Content-length : 此标头返回服务器发送的内容的长度,以字节为单位.

  • Etag : 此标头用于显示文档或视图的修订.

状态代码

以下是http标头发送的状态代码的表格形式及其描述.

Sr.No.状态代码&说明
1

200 : 好的

当请求成功完成时,将发出此状态.

2

201 : 创建

创建文档时将发出此状态.

3

202 : 接受

接受请求时将发出此状态.

4

404 : 未找到

当服务器无法找到所请求的内容时,将发出此状态.

5

405 : 资源不允许

当使用的HTTP请求类型无效时,将发出此状态.

6

409 : 冲突

只要发生任何更新冲突,就会发出此状态.

7

415 : 错误的内容类型

此状态表示服务器不支持所请求的内容类型.

8

500 : 内部服务器错误

只要请求中发送的数据无效,就会发出此状态.

HTTP URL路径

使用某些url路径,您可以直接与数据库交互.以下是此类网址路径的表格格式.

Sr.No.网址&操作
1

PUT/db

此网址用于创建新数据库.

2

GET/db

这url用于获取有关现有数据库的信息.

3

PUT/db/document

此网址用于创建文档/更新现有文档.

4

GET/db/document

此网址用于获取文档.

5

DELETE/db/document

此URL用于从指定数据库中删除指定文档.

6

GET/db/_design/design-doc

此网址用于获得设计文档的定义.

7

GET/db/_design/designdoc/_view/view-name

此URL用于从指定数据库访问设计文档中的视图,视图名称.