本文介绍了通过HTTP/HTTPS POST请求调用内容检测API的请求结构。

请求方法

我们支持基于URL发起HTTP/HTTPS POST请求。请求参数是JSON格式的结构体,以http body的方式发送到服务器端。其中,公共查询参数clientInfo位于url query参数里。

以下一条未编码的图片同步检测请求示例:
http://green.cn-shanghai.aliyuncs.com/green/image/scan?clientInfo={"userId":"120234234","userNick":"Mike","userType":"others"}
其中,
  • http指定了请求通信协议。
  • green.cn-shanghai.aliyuncs.com指定了内容检测API服务的服务接入地址。
  • green/image/scan指定了具体的业务接口,即图片同步检测接口。
  • clientInfo={"ip":"127.0.0.2","userId":"120234234","userNick":"Mike","userType":"others"} 指定了公共查询参数。

通信协议

支持通过HTTP或HTTPS协议请求通信。为了获得更高的安全性,推荐您使用HTTPS协议发送请求,尤其是涉及敏感数据时。

请求参数

您需要在每个请求中指定公共请求参数和具体接口规定的业务请求参数。其中,业务参数以body的方式透传,body结构说明请参照各接口API的具体描述。

字符编码

请求及返回结果都使用UTF-8字符集进行编码。