- 产品介绍
- 接口文档
- 服务商
- 官方客服
你好，朋友
这是一个模板连接器，连接的是百度智能云官方的【人脸识别】API，注意，是V3版的
其官方文档地址为：https://ai.baidu.com/docs#/Face-Detect-V3/top
该API 基于深度学习的人脸识别方案，准确识别图片中的人脸信息，提供人脸属性识别、关键点定位、人脸1：1比对、人脸1：N识别、活体检测等能力
典型功能如下：
人脸检测与属性分析：精准定位图中人脸，获得眼、口、鼻等72个关键点位置，分析性别、年龄、表情等多种人脸属性
人脸搜索：针对一张人脸照片，在指定人脸集合中搜索，找出最相似的一张脸或多张人脸，并给出相似度分值
活体检测：提供离线/在线方式的活体检测能力，判断操作用户是否为真人，有效抵御照片、视频、模具等作弊攻击
基于深度学习的人脸识别方案，准确识别图片中的人脸信息，提供人脸属性识别、关键点定位、人脸1：1比对、人脸1：N识别、活体检测等能力
基于深度学习的人脸识别方案，准确识别图片中的人脸信息，提供人脸属性识别、关键点定位、人脸1：1比对、人脸1：N识别、活体检测等能力
基于深度学习的人脸识别方案，准确识别图片中的人脸信息，提供人脸属性识别、关键点定位、人脸1：1比对、人脸1：N识别、活体检测等能力
基于深度学习的人脸识别方案，准确识别图片中的人脸信息，提供人脸属性识别、关键点定位、人脸1：1比对、人脸1：N识别、活体检测等能力
人脸检测与属性分析
接口地址：http://route.showapi.com/2009-15 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 image String 是 base64编码后的图片数据，需urlencode，编码后的图片大小不超过2m max_face_num String 1 1 否 最多处理人脸的数目，默认值为1，仅检测图片中面积最大的那个人脸 face_fields String 否 包括age,beauty,expression,faceshape,gender,glasses,landmark,race,qualities信息，逗号分隔，默认只返回人脸框、概率和旋转角度 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-15","my_appId","my_appSecret") .addTextPara("image","") .addTextPara("max_face_num","1") .addTextPara("face_fields","") .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数据结构）： 展开收起
名称 类型 示例值 描述 face_num Number 1 检测到的图片中的人脸数量 face_list Object[] 人脸信息列表，具体包含的参数参考下面的列表。 - 0 Object - face_token String 35235asfas21421fakghktyfdgh68bio 人脸图片的唯一标识 - location Object 人脸在图片中的位置 - left Number 117 人脸区域离左边界的距离 - top Number 131 人脸区域离上边界的距离 - width Number 172 人脸区域的宽度 - height Number 170 人脸区域的高度 - rotation Number 4 人脸框相对于竖直方向的顺时针旋转角，[-180,180] - face_probability Number 1 人脸置信度，范围【0~1】，代表这是一张人脸的概率，0最小、1最大。 - angle Object 人脸旋转角度参数 - yaw Number -0 三维旋转之左右旋转角[-90(左), 90(右)] - pitch Number 2 三维旋转之俯仰角度[-90(上), 90(下)] - roll Number 2 平面内旋转角[-180(逆时针), 180(顺时针)] - landmark Object[] 4个关键点位置，左眼中心、右眼中心、鼻尖、嘴中心。face_field包含landmark时返回 - 0 Object - x Number 162 - y Number 163 - landmark72 Object[] 72个特征点位置 face_field包含landmark72时返回 - 0 Object - x Number 116 - y Number 170 - age Number 29 年龄 ，当face_field包含age时返回 - beauty Number 55 美丑打分，范围0-100，越大表示越美。当face_fields包含beauty时返回 - expression Object 表情，当 face_field包含expression时返回 - type String smile none:不笑；smile:微笑；laugh:大笑 - probability Number 1 表情置信度，范围【0~1】，0最小、1最大。 - gender Object 性别，face_field包含gender时返回 - type String male male:男性 female:女性 - probability Number 1 性别置信度，范围【0~1】，0代表概率最小、1代表最大。 - glasses Object 是否带眼镜，face_field包含glasses时返回 - type String sun none:无眼镜，common:普通眼镜，sun:墨镜 - probability Number 1 眼镜置信度，范围【0~1】，0代表概率最小、1代表最大。 - race Object 人种 face_field包含race时返回 - type String yellow yellow: 黄种人 white: 白种人 black:黑种人 arabs: 阿拉伯人 - probability Number 1 人种置信度，范围【0~1】，0代表概率最小、1代表最大。 - face_shape Object 真实人脸/卡通人脸 face_field包含face_type时返回 - type String triangle human: 真实人脸 cartoon: 卡通人脸 - probability Number 1 人脸类型判断正确的置信度，范围【0~1】，0代表概率最小、1代表最大。 - quality Object 人脸质量信息。face_field包含quality时返回 - occlusion Object 人脸各部分遮挡的概率，范围[0~1]，0表示完整，1表示不完整 - left_eye Number 0 左眼遮挡比例，[0-1] ，1表示完全遮挡 - right_eye Number 0 右眼遮挡比例，[0-1] ， 1表示完全遮挡 - nose Number 0 鼻子遮挡比例，[0-1] ， 1表示完全遮挡 - mouth Number 0 嘴巴遮挡比例，[0-1] ， 1表示完全遮挡 - left_cheek Number 0 左脸颊遮挡比例，[0-1] ， 1表示完全遮挡 - right_cheek Number 0 右脸颊遮挡比例，[0-1] ， 1表示完全遮挡 - chin Number 0 下巴遮挡比例，，[0-1] ， 1表示完全遮挡 - blur Number 0 人脸模糊程度，范围[0~1]，0表示清晰，1表示模糊 - illumination Number 141 取值范围在[0~255], 表示脸部区域的光照程度 越大表示光照越好 - completeness Number 1 人脸完整度，0或1, 0为人脸溢出图像边界，1为人脸都在图像边界内 ...
返回示例：{
"face_num": 1,
"face_list": [
{
"face_token": "35235asfas21421fakghktyfdgh68bio",
"location": {
"left": 117,
"top": 131,
"width": 172,
"height": 170,
"rotation": 4
},
"face_probability": 1,
"angle" :{
"yaw" : -0.34859421849251,
"pitch": 1.9135693311691,
"roll" :2.3033397197723
},
"landmark": [
{
"x": 161.74819946289,
"y": 163.30244445801
}
],
"landmark72": [
{
"x": 115.86531066895,
"y": 170.0546875
}
],
"age": 29.298097610474,
"beauty": 55.128883361816,
"expression": {
"type": "smile",
"probability" : 0.5543018579483
},
"gender": {
"type": "male",
"probability": 0.99979132413864
},
"glasses": {
"type": "sun",
"probability": 0.99999964237213
},
"race": {
"type": "yellow",
"probability": 0.99999976158142
},
"face_shape": {
"type": "triangle",
"probability": 0.5543018579483
},
"quality": {
"occlusion": {
"left_eye": 0,
"right_eye": 0,
"nose": 0,
"mouth": 0,
"left_cheek": 0.0064102564938366,
"right_cheek": 0.0057411273010075,
"chin": 0
},
"blur": 1.1886881756684e-10,
"illumination": 141,
"completeness": 1
}
}
]
}
人脸库-人脸注册
接口地址：http://route.showapi.com/2009-4 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 image String 是 image_type String BASE64 是 group_id String 是 user_id String 是 user_info String 否 action_type String APPEND 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-4","my_appId","my_appSecret") .addTextPara("image","") .addTextPara("image_type","BASE64") .addTextPara("group_id","") .addTextPara("user_id","") .addTextPara("user_info","") .addTextPara("action_type","APPEND") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 face_token String location Object - left Number - top Number - width Number - height Number - rotation Number log_id String ...
返回示例：{
"face_token": "2fa64a88a9d5118916f9a303782a97d3",
"location": {
"left": 117,
"top": 131,
"width": 172,
"height": 170,
"rotation": 4
}
}
人脸库-人脸更新
接口地址：http://route.showapi.com/2009-13 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 user_id String 是 image String 是 user_info String 否 group_id String 是 action_type String UPDATE 否 image_type String BASE64 是 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-13","my_appId","my_appSecret") .addTextPara("user_id","") .addTextPara("image","") .addTextPara("user_info","") .addTextPara("group_id","") .addTextPara("action_type","UPDATE") .addTextPara("image_type","BASE64") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 face_token String location Object - left Number - top Number - width Number - height Number - rotation Number log_id String ...
返回示例：{
"face_token": "2fa64a88a9d5118916f9a303782a97d3",
"location": {
"left": 117,
"top": 131,
"width": 172,
"height": 170,
"rotation": 4
}
}
人脸库-人脸删除
接口地址：http://route.showapi.com/2009-3 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 user_id String 是 group_id String 是 face_token String 是 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-3","my_appId","my_appSecret") .addTextPara("user_id","") .addTextPara("group_id","") .addTextPara("face_token","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 log_id Number error_code Number error_msg String ...
返回示例：{ "log_id": 73473737}
人脸库-用户信息查询
接口地址：http://route.showapi.com/2009-14 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 user_id String 是 group_id String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-14","my_appId","my_appSecret") .addTextPara("user_id","") .addTextPara("group_id","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 user_list Object[] - 0 Object - user_info String - group_id String ...
返回示例：{
"user_list": [
{
"user_info": "user info ...",
"group_id": "gid1"
}
]
}
人脸库-获取用户列表(组内用户列表查询)
接口地址：http://route.showapi.com/2009-10 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 group_id String 是 start String 0 否 end String 100 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-10","my_appId","my_appSecret") .addTextPara("group_id","") .addTextPara("start","0") .addTextPara("end","1000") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 log_id Number user_id_list String[] ...
返回示例：{ "log_id": 3314921889,
"user_id_list": [
"uid1",
"uid2"
]
}
人脸库-获取用户人脸列表
接口地址：http://route.showapi.com/2009-11 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 user_id String 是 group_id String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-11","my_appId","my_appSecret") .addTextPara("user_id","") .addTextPara("group_id","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 face_list Object[] - 0 Object - face_token String - ctime String log_id Number ...
返回示例：{
"face_list": [
{
"face_token": "fid1",
"ctime": "2018-01-01 00:00:00"
},
{
"face_token": "fid2",
"ctime": "2018-01-01 10:00:00"
}
],
"log_id": 3314921889
}
人脸库-组间复制用户
接口地址：http://route.showapi.com/2009-2 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 dst_group_id String 是 user_id String 是 src_group_id String 是 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-2","my_appId","my_appSecret") .addTextPara("dst_group_id","") .addTextPara("user_id","") .addTextPara("src_group_id","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 log_id Number error_code Number error_msg String ...
返回示例：
// 发生错误时返回值
{
"error_code": 223111,
"log_id": 3111284097,
"error_msg": "dst group is not exist"
}
人脸库-组内删除用户
接口地址：http://route.showapi.com/2009-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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 group_id String 是 user_id String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-1","my_appId","my_appSecret") .addTextPara("group_id","") .addTextPara("user_id","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 log_id Number error_code Number error_msg String ...
返回示例：// 发生错误时返回值
{
"error_code": 223103,
"log_id": 815967402,
"error_msg": "user is not exist"
}
在线活体检测
接口地址：http://route.showapi.com/2009-5 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 image String 是 option String 否 face_fields String 否 image_type String 是 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-5","my_appId","my_appSecret") .addTextPara("image","") .addTextPara("option","COMMON") .addTextPara("face_fields","") .addTextPara("image_type","BASE64") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 thresholds Object - frr_1e-4 Number - frr_1e-3 Number - frr_1e-2 Number face_liveness Number face_list Object[] - 0 Object - face_token String - location Object - left Number - top Number - width Number - height Number - rotation Number - face_probability Number - angle Object - yaw Number - pitch Number - roll Number - age Number - beauty Number ...
返回示例：{
"thresholds": {
"frr_1e-4": 0.05,
"frr_1e-3": 0.3,
"frr_1e-2": 0.9
},
"face_liveness": 0.05532243927,
"face_list": [
{
"face_token": "df46f7c7db4aa09a093c26fb8d1a8d44",
"location": {
"left": 328.9026489,
"top": 97.16340637,
"width": 162,
"height": 154,
"rotation": 32
},
"face_probability": 1,
"angle": {
"yaw": 10.16196251,
"pitch": 2.244354248,
"roll": 33.82199097
},
"age": 23,
"beauty": 20.23693275
}
]
}
人脸库-创建用户组
接口地址：http://route.showapi.com/2009-16 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 group_id String 否
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-16","my_appId","my_appSecret") .addTextPara("group_id","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 error_code Number log_id Number ...
返回示例：{
"error_code": 0,
"log_id": 3314921889
}
人脸库-删除用户组
接口地址：http://route.showapi.com/2009-17 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 group_id String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-17","my_appId","my_appSecret") .addTextPara("group_id","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 error_code Number log_id Number ...
返回示例：{
"error_code":0,
"log_id": 3314921889
}
人脸库-用户组列表
接口地址：http://route.showapi.com/2009-18 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 start Number 0 否 length Number 100 否
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-18","my_appId","my_appSecret") .addTextPara("start","0") .addTextPara("length","1000") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 group_id_list String[] ...
返回示例：{
"group_id_list": [
"gid1",
"gid2"
]
}
人脸库-人脸搜索
接口地址：http://route.showapi.com/2009-19 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 image String 是 image_type String BASE64 是 group_id_list String 是 user_id String 否 max_user_num Number 1 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-19","my_appId","my_appSecret") .addTextPara("image","") .addTextPara("image_type","BASE64") .addTextPara("group_id_list","") .addTextPara("user_id","") .addTextPara("max_user_num","5") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 face_token String user_list Object[] - 0 Object - group_id String - user_id String - user_info String - score Number ...
返回示例：{
"face_token": "fid",
"user_list": [
{
"group_id" : "test1",
"user_id": "u333333",
"user_info": "Test User",
"score": 99.3
}
]
}
人脸库-M:N识别
接口地址：http://route.showapi.com/2009-20 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 image String 是 image_type String BASE64 是 group_id_list String 是 max_face_num Number 1 否 match_threshold Number 80 否 max_user_num Number 1 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2009-20","my_appId","my_appSecret") .addTextPara("image","") .addTextPara("image_type","BASE64") .addTextPara("group_id_list","") .addTextPara("max_face_num","5") .addTextPara("match_threshold","90") .addTextPara("max_user_num","10") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 error_code Number error_msg String log_id Number timestamp Number cached Number result Object - face_num Number - face_list Object[] - 0 Object - face_token String - location Object - left Number - top Number - width Number - height Number - rotation Number - user_list Object[] - 0 Object - group_id String - user_id String - user_info String - score Number ...
返回示例：{
"error_code":0,
"error_msg":"SUCCESS",
"log_id":240483475,
"timestamp":1535533440,
"cached":0,
"result":{
"face_num":1,
"face_list":[
{
"face_token":"6fe19a6ee0c4233db9b5bba4dc2b9233",
"location":{
"left":31.95568085,
"top":120.3764267,
"width":87,
"height":85,
"rotation":-5
},
"user_list":[
{
"group_id":"group1",
"user_id":"5abd24fd062e49bfa906b257ec40d284",
"user_info":"userinfo1",
"score":69.85684967041
},
{
"group_id":"group1",
"user_id":"2abf89cffb31473a9948268fde9e1c3f",
"user_info":"userinfo2",
"score":66.586112976074
}
]
}
]
}
}
服务商介绍：易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。
易源数据通过打破资源壁垒，搭建起数据资源的基础设施，将接口纳入统一的接口池，把多个异构数据源合并到同一根管线上，以统一的访问和控制方式，对外提供统一格式的数据。
让开发者可以像搭积木一样通过各种API操纵资源。
截至2017年12月，平台已经拥有API接口230个，日调用量2000万，覆盖全网10万+真实消费者，为超过3000+的企业用户提供全域数据服务。
联系方式：
电话： 4009988033
微博： http://www.weibo.com/showapi
邮箱： services@showapi.com
QQ： 3007663665
微信： show_api
进制数据介绍：
企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源，同时进制数据提供数据交易等服务。通过进制数据，不仅开发成本极大降低，而且可以获得其他丰富的数据服务：数据交易，数据分析，区块链Token管理等服务。
联系我们：
电话：173-6457-5198
QQ① 群：792473404
客服 QQ：1643296538
微信客服：binstds
扫描二维码添加客服微信
工作时间：
周一至周五 9：00 - 21：00（其中周三为 9:00 - 18:00）
周六 9:00 - 12:00（节假日除外）
进制数据团队
2020.01.01