文档

公共参数

更新时间:

调用网盘与相册服务PDS的API时需要提供多个请求头参数,调用API后PDS会有返回值。本文为您介绍调用PDS API时所需的公共请求头和返回的公共参数。

公共请求参数

公共请求参数是指每个接口都需要使用到的请求参数,根据认证方式的不同,公共头有所不同,见下方说明。

使用阿里云AccessKey签名认证时的公共请求头

名称

类型

是否必须

描述

Authorization

String

用于验证请求合法性的认证信息,采用acs AccessKeyId:signature格式。

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

客户端需要的返回值类型,只支持 application/json

Host

String

访问域名。

x-acs-signature-nonce

String

唯一随机数,用于防止网络重放攻击。用户在不同请求中要使用不同的随机数值。

x-acs-signature-method

String

签名方法,目前只支持HMAC-SHA1

x-acs-signature-version

String

签名版本,目前是1.0。

使用临时访问令牌AccessToken认证时的公共请求头

名称

类型

是否必须

描述

Host

String

访问域名。

Authorization

String

用于验证请求合法性的认证信息,采用Bearer {AccessToken}格式。其中{AccessToken}是指访问令牌,请根据实际情况替换。

公共返回参数

用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码RequestId给用户。

返回示例如下:

{
    "RequestId": "5B467B38-5110-337D-99BA-33149166F546",
    /* 返回结果数据 */
}