京东云-人脸检测与属性分析

京东云-人脸检测与属性分析

接口地址：http://route.showapi.com/1955-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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起 

参数名称	类型	默认值	示例值	必须	描述
return_landmark	Number		0	否	是否返回关键点，0为不返回，1为返回25个关键点，2为返回106个关键点，默认为0
return_attr	Number		0	否	是否返回人脸属性，0为不返回，1为返回，默认为0
face_detect_num	Number		0	否	最多处理人脸的数目，默认值为0，检测图片中所有的人脸，并返回相应的属性值, 人脸数目不超过100
imageBase64	String		/9j/4AAQSkZJR.....	是	图像Base64编码值，图片格式：bmp, jpg, jpeg, png, jfif，图片像素尺寸：最小 48*48 像素，最大 4096*4096 像素，图片文件大小：小于2MB
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1955-1","my_appId","my_appSecret") .addTextPara("return_landmark","0") .addTextPara("return_attr","0") .addTextPara("face_detect_num","0") .addTextPara("imageBase64","/9j/4AAQSkZJR.....") .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数据结构）： 展开收起 

名称	类型	示例值	描述
jd_ret	Object		京东云返回体
-  charge	Object		false：不扣费， true：扣费
-  code	String	10000	参见错误码-系统级错误码
-  msg	String	查询成功,扣费	参见错误码-系统级错误码
-  remain	Number	499	按天计算剩余调用次数
-  remainSeconds	Number	-1
-  remainTimes	Number	499
-  result	Object		查询结果
-  message	String	success	错误信息，参见错误码-业务级错误码
-  requestid	String	d40e800db4a64ddf9e3381ee875efba7
-  result	String	{"errorMsg":"success","faceNum":1,"faces":[{"faceDetectionResult":{"conf":0.99875975,"height":523.61,"left":241.98712,"pitch":-9.666127,"points":[],"roll":16.345076,"top":392.40027,"width":447.7713,"yaw":18.985561}}],"serialNo":"d40e800db4a64ddf9e3381ee875efba7","status":0,"usedTime":0}	被检测出结果信息，详情参见帮助手册
-  status	Number	0	返回结果，0表示成功；非0为对应错误号，参见错误码-业务级错误码
remark	String
ret_code	Number	0
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "d1efdf346d0c432e86d96eb1c02a6a38", "showapi_res_code": 0, "showapi_res_body": { "jd_ret": { "charge": true, "code": "10000", "msg": "查询成功,扣费", "remain": 499, "remainSeconds": -1, "remainTimes": 499, "result": { "message": "success", "requestid": "d40e800db4a64ddf9e3381ee875efba7", "result": "{\"errorMsg\":\"success\",\"faceNum\":1,\"faces\":[{\"faceDetectionResult\":{\"conf\":0.99875975,\"height\":523.61,\"left\":241.98712,\"pitch\":-9.666127,\"points\":[],\"roll\":16.345076,\"top\":392.40027,\"width\":447.7713,\"yaw\":18.985561}}],\"serialNo\":\"d40e800db4a64ddf9e3381ee875efba7\",\"status\":0,\"usedTime\":0}", "status": 0 } }, "remark": "", "ret_code": 0 } }