構造請求
更新時間 2022-11-15 22:42:30
最近更新時間: 2022-11-15 22:42:30
分享文章
請求的URI
請求URI由如下部分組成：{URI-scheme}://{Endpoint}/{resource-path}?{query-string}
| 參數 | 描述 | 是否必選 |
|---|---|---|
| URI-scheme | 用于傳輸請求的協議，當前所有API均采用HTTPS協議。 | 是 |
| Endpoint | 當前資源池或者通用的域名 | 是 |
| resource-path | 資源路徑，也即API訪問路徑。從具體API的URI模塊獲取，例如“獲取用戶1信息”API的resource-path為“/users/1”。 | 是 |
| query-string | 查詢參數，是可選部分，并不是每個API都有查詢參數。查詢參數前面需要帶一個“?”，形式為“參數名=參數取值”，例如“?userID=1”，表示查詢用戶ID為1的數據。 | 是 |
請求方法
| 方法 | 說明 |
|---|---|
| GET | 請求服務器返回指定資源。 |
| PUT | 請求服務器更新指定資源。 |
| POST | 請求服務器新增資源或執行特殊操作。 |
| DELETE | 請求服務器刪除指定資源，如刪除對象等。 |
| HEAD | 請求服務器資源頭部。 |
| PATCH | 請求服務器更新資源的部分內容。當資源不存在的時候，PATCH可能會去創建一個新的資源。 |
請求消息頭
附加請求頭字段，主要是用于鑒權的公共字段
| 字段 | 類型 | 描述 |
|---|---|---|
| Content-Type | String | 消息體的類型（格式），統一為：application/json |
| Eop-Authorization | String | 公鑰，為ctyun-eop-ak的值 |
| Header | String | 待簽名的header參數列表，以分號分割，如：Header=eop-date;host |
| Signature | String | 計算得到的用于鑒權的簽名，生成方式參見鑒權章節 |
請求消息體
請求消息體可選，格式統一為JSON，具體內容參見各個API接口說明。
