本文介紹事件總線EventBridge的API的公共請求頭和公共返回頭信息。

公共請求頭部

公共請求參數是指每個接口都需要使用到的請求參數。

參數名稱 示例 是否必選 說明
Authorization acs <yourAccessKeyId>:<yourSignature> 是 用于驗證請求合法性的認證信息，采用AccessKeyId:Signature的形式。
Content-Length 26 是 RFC 2616中定義的HTTP請求內容長度。
Content-Type application/json 是 RFC 2616中定義的HTTP請求內容類型。
Content-MD5 0e30656********0bc6f70bbdfe 是 HTTP協議消息體的128-bit MD5散列值轉換成Base64編碼的結果。為了防止所有請求被篡改，建議所有請求都附加該信息。
Date Sat, 18 Apr 2020 05:30:41 GMT 是 請求的構造時間，目前只支持GMT格式。
Host cs.aliyuncs.com 是 請求的服務地址，例如：123456789098****.eventbridge.aliyuncs.com。
Accept application/json 是 客戶端需要的返回值類型，支持application/json和application/xml。
x-eventbridge-version 2020-04-01 是 API版本號。目前版本號為2020-04-01。
x-acs-region-id cn-beijing 否 地域ID。
x-acs-signature-nonce f63659d4-10ac-483b-99da-ea8fde61**** 否 唯一隨機數，用于防止網絡重放攻擊。您在不同請求間要使用不同的隨機數值。
x-acs-signature-method HMAC-SHA1 是 用戶簽名方式，目前只支持HMAC-SHA1。

示例

POST /openapi/createEventBus HTTP/1.1
Host: 123456789098****.eventbridge.cn-hangzhou.aliyuncs.com
Accept: application/json
Date: Sat, 18 Apr 2020 05:30:41 GMT
x-eventbridge-version: 2020-04-01
Authorization: acs vZ3VL0SuJdHi****:Jo2PbTj******zYAYoYslKLvWzg=
Content-Type: application/json;charset=UTF-8
Content-Length: 26

公共返回頭部

每次接口調用請求，無論成功與否，系統都會返回一個唯一識別碼RequestId。調用API服務后返回數據采用統一格式。返回的HTTP狀態碼如下：

  • 2xx：調用成功。
  • 4xx：調用失敗。
  • 5xx：調用失敗。

JSON示例

{
    "RequestId": "4C467B38-3910-447D-87BC-AC049166****"
    /* 返回結果數據 */
}