帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

公共字段

公共参数是所有 API 请求都必需的参数,这里列出公共的 HTTP 头字段。

请求头字段 (Request Header)

Header Name Description
Host 指定所请求资源的主机名及端口。在HTTP/1.1中为必填字段,可以为空置。HTTP/1.0中为可选字段。
http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.23
Authorization 认证所需信息。
http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.8
Content-Type 请求实体的MIME类型。总长度不可超过255个字符,且应该符合rfc文档的规范。若客户端未指定Content-Type或值为空, 服务端将按application/oct-stream处理。
http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
当使用 POST 和 PUT 方法时需要
Date 请求发送时的时间。格式由RFC 822定义,如: Date: Tue, 15 Nov 1994 08:12:31 GMT
http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.18
Date 指定的时间和 QingDNS 服务器时间差不能超过 15 分钟,否则会忽略该请求。

响应头字段 (Response Header)

Header Name Description
Content-Length 服务端返回的消息实体的传输长度,以字节为单位
http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
Content-Type 服务端返回的消息实体的MIME类型。目前只支持”application/json“格式
http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
Date 服务端返回(Response)时的日期和时间。格式由RFC 822定义,如:
Date: Tue, 15 Nov 1994 08:12:31 GMT
http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.18