公共头域

公共请求头域

公共头域 描述
host 主机名。
x-bce-date 表示日期的字符串,符合API规范。
x-bce-request-id 请求ID。
authorization 包含Access Key与请求签名。
content-type application/json; charset=utf-8。
content-length 上传Object的大小,以字节为单位。

下面是一个标准的用户获取指定文档信息时的请求头域内容:

GET /v2/document/<documentId> HTTP/1.1
host: doc.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v2/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:04:26Z/1800/host;x-bce-db1ad7075b37616b846a356d1db86e73abba1aed51b4d7b0d95321f69f17250b1

DOC的API服务要求使用JSON格式(“创建文档”除外)的结构体来描述一个请求的具体内容。 下面是一个标准的用户创建通知时的请求消息体格式:

{
    "name": "demo_notification",
    "endpoint": "http://doc.domain.com/notify"
}

DOC的API服务采用JSON格式的消息体作为响应返回的格式。下面是一个标准的用户查询指定文档时的完整的请求返回示例:

HTTP/1.1 200 OK
x-bce-request-id: 47281222-f0ff-4f80-9a4d-0140ff77dcd0
Date: Tue, 24 Mar 2015 13:04:27 GMT
Content-Type: application/json;charset=UTF-8

{
    "docId":"doc-fhepatsnpn4rk9z",
    "title":"demo",
    "format":"doc",
    "createTime":"2015-03-24T13:37:10Z"
}