公共請求參數(shù)是用于標(biāo)識目標(biāo)API、用戶身份、簽名等通用信息的參數(shù),每次發(fā)起API請求時均需要攜帶這些參數(shù)。如非必要,在每個單獨的接口文檔中不再對這些參數(shù)進(jìn)行說明。
公共請求參數(shù)
公共請求參數(shù)應(yīng)作為HTTP請求的消息頭(Header)攜帶在請求中,具體取值如下:
名稱 | 是否必須 | 描述 |
---|---|---|
x-acs-action | 是 | API的名稱,取值請參見數(shù)據(jù)服務(wù)。 |
x-acs-version | 是 | API版本,格式為YYYY-MM-DD。例如:2018-01-01。 |
x-acs-signature-nonce | 否 | 唯一隨機(jī)數(shù),用于防止網(wǎng)絡(luò)重放攻擊。用戶在不同請求間要使用不同的隨機(jī)數(shù)值。 |
x-acs-signature-method | 非匿名請求必須 | 用戶簽名方式,目前支持HMAC-SHA1。 |
Authorization | 非匿名請求必須 | 用于驗證請求合法性的認(rèn)證信息,格式為acs AccessKeyId:Signature 。其中AccessKeyId為用戶的訪問密鑰ID;Signature為請求簽名,取值請參見簽名機(jī)制。
|
Date | 是 | HTTP 1.1協(xié)議中規(guī)定的GMT 時間,例如:Tue 9 Apr 2019 07:35:29 GMT。 |
Accept | 否 | 客戶端需要的返回值類型,取值:
|
Content-MD5 | 否 | HTTP請求正文的128-bit MD5散列值轉(zhuǎn)換成BASE64編碼的結(jié)果。 |