公共請求參數(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 客戶端需要的返回值類型,取值:
  • application/json(推薦)。
  • application/xml(默認(rèn)值)。
Content-MD5 HTTP請求正文的128-bit MD5散列值轉(zhuǎn)換成BASE64編碼的結(jié)果。