本文介绍了通过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协议发送请求,尤其是涉及敏感数据时。

接入地址

内容检测API服务的接入地址为:
http(s)://green.{region}.aliyuncs.com/业务API
其中,
  • {region}表示地域,支持的地域见下表。
    名称 代码 外网接入地址 是否支持HTTPS 是否支持ECS内网接入
    华东 2 cn-shanghai green.cn-shanghai.aliyuncs.com SDK >= 3.0.0 支持,旧版本不支持 不支持
    华北 2 cn-beijing green.cn-beijing.aliyuncs.com SDK >= 3.0.0 支持,旧版本不支持 不支持
    新加坡 ap-southeast-1 green.ap-southeast-1.aliyuncs.com SDK >= 3.0.0 支持,旧版本不支持 不支持
    美西 us-west-1 green.us-west-1.aliyuncs.com SDK >= 3.0.0 支持,旧版本不支持 不支持
  • 业务API表示具体接口的URI,参照各接口API的具体描述。
例如,以下地址指向华东2地域的图片鉴黄服务:
http(s)://green.cn-shanghai.aliyuncs.com/green/image/scan

请求参数

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

字符编码

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