全部产品
Search
文档中心

智能开放搜索 OpenSearch:请求结构

更新时间:Apr 25, 2022

服务地址

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字符集。