调用网盘与相册服务PDS的API时需要提供多个请求头参数,调用API后PDS会有返回值。本文为您介绍调用PDS API时所需的公共请求头和返回的公共参数。
公共请求参数
公共请求参数是指每个接口都需要使用到的请求参数,根据认证方式的不同,公共头有所不同,见下方说明。
使用阿里云AccessKey签名认证时的公共请求头
名称 | 类型 | 是否必须 | 描述 |
Authorization | String | 是 | 用于验证请求合法性的认证信息,采用 |
Content-Length | long | 是 | RFC 2616中定义的 HTTP请求内容长度。 |
Content-Type | String | 是 | RFC 2616中定义的 HTTP请求内容类型。 |
Content-MD5 | String | 是 | HTTP协议消息体的128-bit MD5散列值转换成BASE64编码的结果。为了防止所有请求被篡改,建议所有请求都附加该信息。 |
Date | String | 是 | 描述请求时间。GMT格式,例如:Wed, 26 Aug. 2015 17:01:00 GMT。 |
Accept | String | 是 | 客户端需要的返回值类型,只支持 |
Host | String | 是 | 访问域名。 |
x-acs-signature-nonce | String | 是 | 唯一随机数,用于防止网络重放攻击。用户在不同请求中要使用不同的随机数值。 |
x-acs-signature-method | String | 是 | 签名方法,目前只支持 |
x-acs-signature-version | String | 是 | 签名版本,目前是1.0。 |
使用临时访问令牌AccessToken认证时的公共请求头
名称 | 类型 | 是否必须 | 描述 |
Host | String | 是 | 访问域名。 |
Authorization | String | 是 | 用于验证请求合法性的认证信息,采用 |
公共返回参数
用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码RequestId给用户。
返回示例如下:
{
"RequestId": "5B467B38-5110-337D-99BA-33149166F546",
/* 返回结果数据 */
}