公共请求参数是用于标识目标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 | 否 | 客户端需要的返回值类型,取值:
|
Content-MD5 | 否 | HTTP请求正文的128-bit MD5散列值转换成BASE64编码的结果。 |