笔记列表:
CouchDB-HTTP API
使用HTTP请求标头,可以与CouchDB通信。通过这些请求,我们可以从数据库中检索数据,以文档的形式将数据存储到数据库中,并且可以查看和格式化存储在数据库中的文档。
HTTP请求格式
与数据库通信时,我们将使用不同的请求格式,例如get,head,post,put,delete和copy。对于CouchDB中的所有操作,输入数据和输出数据结构将采用JavaScript Object Notation(JSON)对象的形式。
以下是用于与CouchDB通信的HTTP协议的不同请求格式。
-
GET-此格式用于获取特定项目。要获得不同的商品,您必须发送特定的网址格式。在使用此GET请求的CouchDB中,我们可以以JSON文档的形式(在大多数情况下)获取静态项,数据库文档和配置以及统计信息。
-
HEAD -HEAD方法用于获取GET请求的HTTP标头,而没有响应主体。
-
POST-发布请求用于上传数据。在使用POST请求的CouchDB中,您可以设置值,上载文档,设置文档值,还可以启动某些管理命令。
-
PUT-使用PUT请求,您可以创建新的对象,数据库,文档,视图和设计文档。
-
删除-使用DELETE请求,您可以删除文档,视图和设计文档。
-
COPY-使用COPY方法,您可以复制文档和对象。
HTTP请求头
应该提供HTTP标头以获取正确的格式和编码。在将请求发送到CouchDB服务器时,您可以将Http请求标头与请求一起发送。以下是不同的Http请求标头。
-
内容类型-此标头用于指定我们与请求一起提供给服务器的数据的内容类型。通常,与请求一起发送的内容的类型将是MIME类型或JSON(应用程序/ json)。强烈建议对请求使用Content-type。
-
接受-此标头用于指定服务器,客户端可以理解的数据类型列表,以便服务器将使用这些数据类型发送其响应。通常,在这里,您可以发送客户端接受的MIME数据类型列表,以冒号分隔。
尽管不需要在CouchDB的查询中使用Accept,但是强烈建议确保客户端可以处理返回的数据。
响应标题
这些是服务器发送的响应的标头。这些标头提供有关服务器作为响应发送的内容的信息。
-
内容类型-此标头指定服务器返回的数据的MIME类型。对于大多数请求,返回的MIME类型为text / plain。
-
缓存控制-此标头建议客户端处理服务器发送的信息。CouchDB通常返回必须重新验证的信息,这表明信息应尽可能进行重新验证。
-
Content-length-此标头返回服务器发送的内容的长度(以字节为单位)。
-
Etag-此标头用于显示文档或视图的修订。
状态码
以下是http标头发送的状态代码的表格形式及其说明。
序号 | 状态码和说明 |
---|---|
1个 |
200-好 请求成功完成后,将发出此状态。 |
2个 |
201-创建 创建文档时将发出此状态。 |
3 |
202-接受 接受请求后,将发出此状态。 |
4 |
404-找不到 当服务器找不到请求的内容时,将发出此状态。 |
5 |
405-不允许资源 当使用的HTTP请求类型无效时,将发出此状态。 |
6 |
409-冲突 每当有任何更新冲突时,就会发出此状态。 |
7 |
415-错误的内容类型 此状态表明服务器不支持请求的内容类型。 |
8 |
500-内部服务器错误 每当请求中发送的数据无效时,就会发出此状态。 |
HTTP URL路径
使用某些URL路径,您可以直接与数据库进行交互。以下是此类url路径的表格格式。
序号 | 网址和操作 |
---|---|
1个 |
PUT /分贝 该URL用于创建新的数据库。 |
2个 |
GET / db 该URL用于获取有关现有数据库的信息。 |
3 |
PUT / db /文件 该URL用于创建文档/更新现有文档。 |
4 |
GET / db / document 该URL用于获取文档。 |
5 |
删除/ db / document 该URL用于从指定的数据库中删除指定的文档。 |
6 |
GET / db / _design / design-doc 该URL用于获取设计文档的定义。 |
7 |
GET / db / _design / designdoc / _view / view-name 该URL用于从指定数据库访问设计文档中的视图,视图名称。 |