全部產品
Search
文件中心

OpenSearch:請求結構

更新時間:Jul 13, 2024

服務地址

OpenSearch為分地區部署,每個地區訪問地址均不同,具體服務地址請查看訪問應用-》基本詳情中的API入口部分擷取,切勿隨便使用。

通訊協定

支援HTTP協議。部分地區(華北1、華北2、華東1、華東2、華南1)已支援HTTPS協議。

要求方法

推送資料只能使用POST方式,搜尋只能使用GET方式。

Content-Type 類型設定注意

  • 使用POST方式向API提交資料時,需要將HTTP請求的“Content-Type”設定為“application/json”,否則可能會導致API解析失敗。

  • 使用GET方式向API提交查詢,需要將HTTP請求的“Content-Type”設定為“application/json”,否則可能會導致API解析失敗。

  • 使用GET方式向API提交查詢,且設定了召回資料格式為XML格式時,可以根據返回的content-type 中定義的格式來解析召回的資料,例如查詢返回內容格式為“application/xml”,則本地程式需通過XML格式解析資料。

簽名參數

每個操作都需在 HTTP 要求中,添加 Authorization(授權)的 Header 來包含簽名(Signature)資訊,表明本次提交的請求操作已被授權,並且還必須包含對應請求操作的其它相關Header參數資訊,詳細描述請參考 V3版API 簽名機制

字元編碼

請求及返回結果都僅支援UTF-8字元集。