CouchDB HTTP API

使用HTTP请求头,你可以使用CouchDB沟通。通过这些要求,我们可以在以文件的形式将数据库从数据库检索数据,存储数据,我们可以看到,以及格式存储在数据库中的文件。

HTTP请求格式

而与数据库通信,我们将使用不同的请求格式,如GET,HEAD,POST,PUT,删除和复制。在CouchDB的所有操作,输入数据和输出数据结构将在JavaScript对象符号(JSON)对象的形式。

以下是HTTP协议的不同要求的格式用来使用CouchDB沟通。

  • GET -这种格式是用来获取特定项目。为了得到不同的项目,你必须发送特定的URL模式。在使用这种GET请求CouchDB的,我们可以得到静态项目,数据库文件和配置,并在JSON文件的形式统计信息(在大多数情况下)。

  • HEAD - HEAD方法用于获取一个GET请求的HTTP头无响应的主体。

  • POST -发布请求被用来上传的数据。在使用POST请求CouchDB的,你可以设置值,上传文件,设置文件值,还可以启动特定的管理命令。

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

  • DELETE -使用delete要求,您可以删除文档,视图和设计文档。

  • COPY -使用复制的方法,你可以复制文件和对象。

HTTP请求头部

HTTP头应供给至得到正确的格式和编码。发送请求到CouchDB的服务器,可以与请求一起发送HTTP请求头。以下是不同的HTTP请求头。

  • Content-type-这个头部是用来指定我们提供给服务器的请求一起的数据的内容类型。主要是我们一起发送内容与请求的类型将是MIME类型或JSON(应用/ JSON)。强烈推荐使用上的请求内容类型。

  • Accept-这头部用于指定服务器,数据类型的客户端可以理解的列表,以便服务器将发送使用这些数据类型,它的响应。一般来说在这里,您可以发送客户接受MIME数据类型,用冒号分隔的列表。

虽然,利用接受CouchDB中的查询是不需要的,强烈建议确保返回的数据可以由客户端来处理。

响应头部

这些是由服务器发送的响应的头部。这些头部文件提供了有关由服务器发送响应为内容的信息。

  • Content-type - 这头指定的MIME类型由服务器返回的数据。对于大多数的请求,返回的MIME类型为text / plain的。

  • Cache-control- 这头表明有关处理由服务器发送的信息的客户端。 CouchDB的大多是返回的必重新验证,这表明信息应尽可能进行重新验证。

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

  • ETAG - 这个头是用来显示一个文档的修订,或视图。

状态代码

以下为HTTP头和它的描述发送的状态代码的表格形式。

200 − OK当请求成功完成时,将会发出此状态。
201 − Created创建文档时将发出此状态。
202 − Accepted当接受请求时,将发出此状态。
404 − Not Found当服务器无法找到所请求的内容时,将发出此状态。
405 − Resource Not Allowed当使用的HTTP请求类型无效时,会发出此状态。
409 − Conflict每当有任何更新冲突时,都会发出此状态。
415 − Bad Content Type此状态表示服务器不支持请求的内容类型。.
500 − Internal Server Error当请求中发送的数据无效时,会发出此状态。

HTTP URL路径

有使用的,可以与数据库直接交互的某些URL路径。以下是此类URL路径的表格格式。

网址操作
PUT / DB这个网址是用来创建一个新的数据库。
GET / DB这个网址是用来获取现有的数据库中的信息。
PUT /db/document此URL用于创建文档/更新现有的文件。
GET /db/document这个网址是用来获取文档。
DELETE /db/document这个网址是用来删除指定的数据库中指定的文件。
GET /db/_design/design-doc使用此URL获得设计文件的定义。
GET /db/_design/designdoc/_view/view-name此URL用于从设计文件从指定的数据库访问视图,视图名。