阿里云-图片鉴黄

阿里云-图片鉴黄

接口地址：http://route.showapi.com/1964-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）

支持格式：json

请求方法：HTTP协议，支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时，enctype=application/x-www-form-urlencoded。 
文件上传的POST时，enctype=multipart/form-data。 

1、系统级参数（所有接入点都需要的参数）： 

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp	String	20141114142239	否	客户端时间。  格式yyyyMMddHHmmss,如20141114142239  为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 

参数名称	类型	默认值	示例值	必须	描述
url	String		https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/wjy/%E5%9B%BE%E7%89%87%E9%89%B4%E9%BB%84.jpg	是	待检测图像的URL。

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1964-1","my_appId","my_appSecret") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/wjy/%E5%9B%BE%E7%89%87%E9%89%B4%E9%BB%84.jpg") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起 

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口  -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称	类型	示例值	描述
ali_ret	Object
-  requestId	String
-  msg	String		错误描述信息。
-  data	Object[]
-  msg	String		错误描述信息。
-  results	Object[]		返回结果。调用成功时（code=200）
-  label	String		检测结果的分类: normal：正常图片，无色情内容 sexy：性感图片 porn：色情图片
-  suggestion	String		建议您执行的操作，取值范围： pass：图片正常，无需进行其余操作；或者未识别出目标对象 review：检测结果不确定，需要进行人工审核；或者识别出目标对象 block：图片违规，建议执行进一步操作（如直接删除或做限制处理）
-  scene	String		图片检测场景，和调用请求中的场景（scenes）对应。
-  rate	Number		结果为该分类的概率，取值范围为[0.00-100.00]。值越高，表示越有可能属于该分类。
-  url	String		对应请求中的URL。
-  extras	Object[]		额外附加信息，可能包含的内容有： imageAdHitLIbInfo：广告识别场景（scenes包含ad）中，若广告检测若命中了自定义文本库，则返回该字段。格式为数组。示例值： "imageAdHitLIbInfo":"[{"context":"好看视频","libCode":"2144002","libName":"预发测试广告相似文本库a"}]"
-  taskId	String		该检测任务的ID。
-  code	Number		错误码，和HTTP的status code一致。
-  code	Number		错误码，和HTTP的status code一致。
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "d48031edad9f4d8baac6b2106d7e962f", "showapi_res_code": 0, "showapi_res_body": { "ali_ret": { "requestId": "C32C385E-2BF8-42DD-8AE5-3C35E1C5C011", "msg": "OK", "data": [ { "msg": "OK", "results": [ { "label": "normal", "suggestion": "pass", "scene": "porn", "rate": 98.62 } ], "url": "http://showapi.mmno.com/api/showapi.bing/img_1366", "extras": [], "taskId": "img3E263uDsQUk70QW6DVS7Yg-1qZZHZ", "code": 200 } ], "code": 200 }, "remark": "", "ret_code": 0 } }