公共请求参数是用于标识目标API、用户身份、签名等通用信息的参数,每次发起API请求时均需要携带这些参数。如非必要,在每个单独的接口文档中不再对这些参数进行说明。

公共请求参数

公共请求参数应作为HTTP请求的消息头(Header)携带在请求中,具体取值如下:

名称 是否必须 描述
x-acs-action API的名称,取值请参见数据服务
x-acs-version API版本,格式为YYYY-MM-DD。例如:2018-01-01。
x-acs-signature-nonce 唯一随机数,用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值。
x-acs-signature-method 非匿名请求必须 用户签名方式,目前支持HMAC-SHA1。
Authorization 非匿名请求必须 用于验证请求合法性的认证信息,格式为acs AccessKeyId:Signature。其中AccessKeyId为用户的访问密钥ID;Signature为请求签名,取值请参见签名机制
Date HTTP 1.1协议中规定的GMT 时间,例如:Tue 9 Apr 2019 07:35:29 GMT。
Accept 客户端需要的返回值类型,取值:
  • application/json(推荐)。
  • application/xml(默认值)。
Content-MD5 HTTP请求正文的128-bit MD5散列值转换成BASE64编码的结果。