腾讯云-人脸核身

第三方服务商
价格:免费使用  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

腾讯云人脸核身·云智慧眼(FaceID)方案,是依托于证件OCR识别、活体检测、1:1人脸比对等AI技术,实现自然人真实身份核验的产品。秒级确认用户身份,帮助提升业务办理效率,降低人力成本。

功能介绍

人脸核身·云智慧眼为您提供了短信、OCR、活体检测、1:1人脸比对的配套服务,可根据您的需求灵活组合。

1.与权威数据库比对

图片

2.与上传照片比对

图片

身份证 OCR识别

支持识别身份证正反面,一次扫描即可返回身份证号、姓名、有效时间等所有字段,数字识别准确率达到 99.9% 以上,在多个字段上处于领先水平。处理倾斜、暗光、曝光、阴影等异常情况稳定性好,自适应判别纠正技术大大提高识别准确率。

活体检测

活体检测, 通过对一段实时录制的自拍视频进行检测,从而确认当前用户为真人,主要针对高安全性要求的人脸核身验证而研发的一种技术, 防止照片、视频、静态3D建模等各种不同类型的攻击; 目前支持唇语读数、动作、静默等多种活体模式,适用于多类验证场景。

人脸比对

人脸比对,根据面部特征,计算两张人脸的相似度,自动进行身份鉴别。立足于腾讯社交数据大平台收集的海量人脸训练集,结合高维 LBP、PCA、LDA 联合贝叶斯、度量学习、迁移学习、深度神经网络,2017年LFW 测评准确度为 99.80%。并支持多场景下的识别验证,对年龄、姿态及光强均有较好的支持度。

银行卡二要素核验


接口地址:http://route.showapi.com/1980-1 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

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

1、系统级参数(所有接入点都需要的参数): 

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

2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 

参数名称类型默认值示例值必须描述
NameString 王均姓名
BankCardString 6222222222222222222银行卡
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-1","my_appId","my_appSecret") .addTextPara("Name","王均") .addTextPara("BankCard","6222222222222222222") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起 

名称类型示例值描述
showapi_res_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,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_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

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

名称类型示例值描述
Response Object  
-  Result String0认证结果码。 '0': '认证通过' '-1': '认证未通过' '-2': '姓名校验不通过' '-3': '银行卡号码有误' '-4': '持卡人信息有误' '-5': '未开通无卡支付' '-6': '此卡被没收' '-7': '无效卡号' '-8': '此卡无对应发卡行' '-9': '该卡未初始化或睡眠卡' '-10': '作弊卡、吞卡' '-11': '此卡已挂失' '-12': '该卡已过期' '-13': '受限制的卡' '-14': '密码错误次数超限' '-15': '发卡行不支持此交易' '-16': '服务繁忙'
-  Description String认证通过认证结果信息。
-  RequestId Stringc6daaf7f-dbdc-4a9d-a20b-9a14ffdd8328唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String调用成功! 
ret_code Number0 
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "Result":"0", "Description":"认证通过", "RequestId":"c6daaf7f-dbdc-4a9d-a20b-9a14ffdd8328" }, "remark":"调用成功!", "ret_code":0 } }

银行卡三要素核验


接口地址:http://route.showapi.com/1980-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
IdCard String
530xxxxxxxxxxx5687
身份证号
Name String
某某某
姓名
BankCard String
617xxxxxxxxxxx1027
银行卡
CertType Number
0
证件类型,请确认该证件为开户时使用的证件类型,未用于开户的证件信息不支持验证。(不填默认0) 0 身份证 1 军官证 2 护照 3 港澳证 4 台胞证 5 警官证 6 士兵证 7 其它证件
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-3","my_appId","my_appSecret") .addTextPara("IdCard","530xxxxxxxxxxx5687") .addTextPara("Name","某某某") .addTextPara("BankCard","617xxxxxxxxxxx1027") .addTextPara("CertType","0") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
Result String
0
认证结果码。 '0': '认证通过' '-1': '认证未通过' '-2': '姓名校验不通过' '-3': '身份证号码有误' '-4': '银行卡号码有误' '-5': '持卡人信息有误' '-6': '未开通无卡支付' '-7': '此卡被没收' '-8': '无效卡号' '-9': '此卡无对应发卡行' '-10': '该卡未初始化或睡眠卡' '-11': '作弊卡、吞卡' '-12': '此卡已挂失' '-13': '该卡已过期' '-14': '受限制的卡' '-15': '密码错误次数超限' '-16': '发卡行不支持此交易' '-17': '服务繁忙'
Description String
认证通过
认证结果信息。
RequestId String
c6daaf7f-dbdc-4a9d-a20b-9a14ffdd8328
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "Result": "0", "Description": "认证通过", "RequestId": "c6daaf7f-dbdc-4a9d-a20b-9a14ffdd8328" }, "remark":"调用成功!", "ret_code":0 } }

银行卡四要素核验


接口地址:http://route.showapi.com/1980-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
Name String
某某某
姓名
BankCard String
617xxxxxxxxxxx1027
银行卡
Phone String
198xxxxxxxx
手机号码
IdCard String
530xxxxxxxxxxx5687
身份证号码
CertType Number
0
证件类型,请确认该证件为开户时使用的证件类型,未用于开户的证件信息不支持验证。(默认0) 0 身份证 1 军官证 2 护照 3 港澳证 4 台胞证 5 警官证 6 士兵证 7 其它证件
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-2","my_appId","my_appSecret") .addTextPara("Name","某某某") .addTextPara("BankCard","617xxxxxxxxxxx1027") .addTextPara("Phone","198xxxxxxxx") .addTextPara("IdCard","530xxxxxxxxxxx5687") .addTextPara("CertType","0") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
Result String
0
认证结果码。 '0': '认证通过' '-1': '认证未通过' '-2': '姓名校验不通过' '-3': '身份证号码有误' '-4': '银行卡号码有误' '-5': '手机号码不合法' '-6': '持卡人信息有误' '-7': '未开通无卡支付' '-8': '此卡被没收' '-9': '无效卡号' '-10': '此卡无对应发卡行' '-11': '该卡未初始化或睡眠卡' '-12': '作弊卡、吞卡' '-13': '此卡已挂失' '-14': '该卡已过期' '-15': '受限制的卡' '-16': '密码错误次数超限' '-17': '发卡行不支持此交易' '-18': '服务繁忙'
Description String
认证通过
认证结果信息。
RequestId String
c6daaf7f-dbdc-4a9d-a20b-9a14ffdd8328
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "Result": "0", "Description": "认证通过", "RequestId": "c6daaf7f-dbdc-4a9d-a20b-9a14ffdd8328" }, "remark":"调用成功!", "ret_code":0 } }

获取动作顺序


接口地址:http://route.showapi.com/1980-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-4","my_appId","my_appSecret") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
ActionSequence String
1,2
动作顺序(2,1 or 1,2) 。1代表张嘴,2代表闭眼。
RequestId String
f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "8582b393806843009b248c0667d9b2ab", "showapi_res_code": 0, "showapi_res_body": { "Response": { "ActionSequence": "1,2", "RequestId": "f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a" }, "remark": "调用成功!", "ret_code": 0 } }

获取数字验证码


接口地址:http://route.showapi.com/1980-12 (注意:接口支持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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-12","my_appId","my_appSecret") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
LiveCode String
4392
数字验证码,如:1234
RequestId String
f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "LiveCode":"4392", "RequestId":"f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a" }, "remark":"调用成功!", "ret_code":0 } }

身份信息认证


接口地址:http://route.showapi.com/1980-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
IdCard String
530xxxxxxxxxxx5687
身份证号
Name String
某某某
姓名
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-5","my_appId","my_appSecret") .addTextPara("IdCard","530xxxxxxxxxxx5687") .addTextPara("Name","某某某") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
Result String
0
认证结果码。 0: 姓名和身份证号一致 -1: 姓名和身份证号不一致 -2: 身份证号错误 -3: 姓名错误 -4: 认证出错
Description String
姓名和身份证号一致
认证结果信息。
RequestId String
94b54cdf-d975-4718-b091-32f8d79d6397
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "Result":"0", "Description":"姓名和身份证号一致", "RequestId":"94b54cdf-d975-4718-b091-32f8d79d6397" }, "remark":"调用成功!", "ret_code":0 } }

照片人脸核身


接口地址:http://route.showapi.com/1980-7 (注意:接口支持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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
IdCard String
530xxxxxxxxxxx5687
身份证号
Name String
某某某
姓名。中文请使用UTF-8编码。
ImageBase64 String
/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMj……………………CnaywossNSxZMdocHZfTJEC37ECTTgkql2HfWYJhNQU+BqEaj25yFFVZFBeIZAAlTKPzBAIhlwUt+YqcFQwXVlw9oV24IeNN1HB2nsKVS02xcmqsj1JpqIBHUc6y8SpGYhbCmaG9IZgkJUNVYVvk5cNI6stlgYxC12DmI33UvgAdXLCAHyI3vEO1+58X9z/9k=
用于人脸比对的照片,图片的BASE64值; BASE64编码后的图片数据大小不超过3M,仅支持jpg、png格式。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-7","my_appId","my_appSecret") .addTextPara("IdCard","530xxxxxxxxxxx5687") .addTextPara("Name","某某某") .addTextPara("ImageBase64","/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMj……………………CnaywossNSxZMdocHZfTJEC37ECTTgkql2HfWYJhNQU+BqEaj25yFFVZFBeIZAAlTKPzBAIhlwUt+YqcFQwXVlw9oV24IeNN1HB2nsKVS02xcmqsj1JpqIBHUc6y8SpGYhbCmaG9IZgkJUNVYVvk5cNI6stlgYxC12DmI33UvgAdXLCAHyI3vEO1+58X9z/9k=") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
Result String
Success
业务错误码,成功情况返回Success, 错误情况请参考下方错误码 列表中FailedOperation部分、 FailedOperation.CompareFail 比对失败。 FailedOperation.CompareLowSimilarity 比对相似度未达到通过标准。 FailedOperation.CompareSystemError 调用比对引擎接口出错。 FailedOperation.FileSaveError 文件存储失败,请稍后重试。 FailedOperation.IdFormatError 输入的身份证号有误。 FailedOperation.IdNameMisMatch 姓名和身份证号不一致,请核实后重试。 FailedOperation.IdNoExistSystem 库中无此号,请到户籍所在地进行核实。 FailedOperation.IdPhotoNoExist 库中无此号照片,请到户籍所在地进行核实。 FailedOperation.IdPhotoPoorQuality 证件图片分辨率太低,请重新上传。 FailedOperation.IdPhotoSystemNoanswer 客户库自建库或认证中心返照失败,请稍后再试。 FailedOperation.LifePhotoDetectFaces 检测到多张人脸。 FailedOperation.LifePhotoDetectFake 实人比对没通过。 FailedOperation.LifePhotoDetectNoFaces 未能检测到完整人脸。 FailedOperation.LifePhotoPoorQuality 传入图片分辨率太低,请重新上传。 FailedOperation.LifePhotoSizeError 传入图片过大或过小。 FailedOperation.NameFormatError 输入的姓名有误。 FailedOperation.UnKnown 内部未知错误。
Description String
成功
业务错误描述
Sim String
89.88
相似度,取值范围 [0.00, 100.00]。推荐相似度大于等于70时可判断为同一人,可根据具体场景自行调整阈值(阈值70的误通过率为千分之一,阈值80的误通过率是万分之一)
RequestId String
f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "Result":"Success", "Description":"成功", "Sim":"89.88", "RequestId":"f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a" }, "remark":"调用成功!", "ret_code":0 } }

活体检测


接口地址:http://route.showapi.com/1980-6 (注意:接口支持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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
VideoBase64 String
AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAEDv1tZGF0AAACrgYF//+q3EXpvebZSLeWLNgg2SPu73gyNjQgL…………………………0YQAAAAAAAAAhaGRscgAAAAAAAAAAbWRpcmFwcGwAAAAAAAAAAAAAAAAtaWxzdAAAACWpdG9vAAAAHWRhdGEAAAABAAAAAExhdmY1Ny44MS4xMDA=
用于活体检测的视频,视频的BASE64值; BASE64编码后的大小不超过5M,支持mp4、avi、flv格式。
LivenessType String
LIP
活体检测类型,取值:LIP/ACTION/SILENT。 LIP为数字模式,ACTION为动作模式,SILENT为静默模式,三种模式选择一种传入。
ValidateData String
0591
数字模式传参:数字验证码(1234),需先调用接口获取数字验证码; 动作模式传参:传动作顺序(2,1 or 1,2),需先调用接口获取动作顺序; 静默模式传参:不需要传递此参数。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-6","my_appId","my_appSecret") .addTextPara("VideoBase64","AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAEDv1tZGF0AAACrgYF//+q3EXpvebZSLeWLNgg2SPu73gyNjQgL…………………………0YQAAAAAAAAAhaGRscgAAAAAAAAAAbWRpcmFwcGwAAAAAAAAAAAAAAAAtaWxzdAAAACWpdG9vAAAAHWRhdGEAAAABAAAAAExhdmY1Ny44MS4xMDA=") .addTextPara("LivenessType","LIP") .addTextPara("ValidateData","0591") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
Result String
Success
业务错误码,成功情况返回Success, 错误情况请参考下方错误码 列表中FailedOperation部分 FailedOperation.ActionCloseEye 未检测到闭眼动作。 FailedOperation.ActionFaceClose 脸离屏幕太近。 FailedOperation.ActionFaceFar 脸离屏幕太远。 FailedOperation.ActionFaceLeft 脸离屏幕太左。 FailedOperation.ActionFaceRight 脸离屏幕太右。 FailedOperation.ActionFirstAction 未检测到第一个动作。 FailedOperation.ActionLightDark 光线太暗。 FailedOperation.ActionLightStrong 光线太强。 FailedOperation.ActionNodetectFace 未能检测到完整人脸。 FailedOperation.ActionOpenMouth 未检测到张嘴动作。 FailedOperation.DbError 数据库异常。 FailedOperation.FileSaveError 文件存储失败,请稍后重试。 FailedOperation.LipFaceIncomplete 脸部未完整露出。 FailedOperation.LipMoveSmall 嘴唇动作幅度过小。 FailedOperation.LipNetFailed 视频拉取失败,请重试。 FailedOperation.LipSizeError 视频为空,或大小不合适,请控制录制时长在6s左右。 FailedOperation.LipVideoInvalid 视频格式有误。 FailedOperation.LipVideoQuaility 视频像素太低。 FailedOperation.LipVoiceDetect 未检测到声音。 FailedOperation.LipVoiceLow 视频声音太小。 FailedOperation.LipVoiceRecognize 声音识别失败。 FailedOperation.LivessBestFrameError 人脸检测失败,无法提取比对照。 FailedOperation.LivessDetectFail 活体检测没通过。 FailedOperation.LivessDetectFake 疑似非真人录制。 FailedOperation.LivessSystemError 调用活体引擎接口出错。 FailedOperation.LivessUnknownError 视频实人检测没通过。 FailedOperation.SilentDetectFail 实人检测失败。 FailedOperation.SilentThreshold 实人检测未达到通过标准。 FailedOperation.SilentTooShort 视频录制时间过短,请录制2秒以上的视频。 FailedOperation.UnKnown 内部未知错误。 FailedOperation.VerificationFail 认证不通过。
Description String
成功
业务错误描述
BestFrameBase64 String
<Imagebase64>
验证通过后的视频最佳截图照片,照片为BASE64编码后的值,jpg格式。
RequestId String
f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "Result":"Success", "Description":"成功", "BestFrameBase64":"<Imagebase64>", "RequestId":"f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a" }, "remark": "调用成功!", "ret_code": 0 } }

活体人脸比对


接口地址:http://route.showapi.com/1980-8 (注意:接口支持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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
ImageBase64 String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQE…………………………TaHcN/8AMH/wTn+E1x8QfH+kveeH2u9B8NaFf6pqtoMLZ6do9j9n1m7bWUBEk0Fz/YosreERKZprsxBkZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
用于人脸比对的照片,图片的BASE64值; BASE64编码后的图片数据大小不超过3M,仅支持jpg、png格式。
VideoBase64 String
AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAEDv1tZGF0AAACrgYF//+q3EXpvebZSLeWLNgg2SPu73gyNjQgLSBjb3JlIDE1MiByMjg1MSBiYTI0ODk5IC0gSC4yNjQvTVBFRy00IEFWQyBjb2RlYyAtIENvcHl……………………aGRscgAAAAAAAAAAbWRpcmFwcGwAAAAAAAAAAAAAAAAtaWxzdAAAACWpdG9vAAAAHWRhdGEAAAABAAAAAExhdmY1Ny44MS4xMDA=
用于活体检测的视频,视频的BASE64值; BASE64编码后的大小不超过5M,支持mp4、avi、flv格式。
LivenessType String
SILENT
活体检测类型,取值:LIP/ACTION/SILENT。 LIP为数字模式,ACTION为动作模式,SILENT为静默模式,三种模式选择一种传入。
ValidateData String
数字模式传参:数字验证码(1234),需先调用接口获取数字验证码; 动作模式传参:传动作顺序(2,1 or 1,2),需先调用接口获取动作顺序; 静默模式传参:空。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-8","my_appId","my_appSecret") .addTextPara("ImageBase64","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQE…………………………TaHcN/8AMH/wTn+E1x8QfH+kveeH2u9B8NaFf6pqtoMLZ6do9j9n1m7bWUBEk0Fz/YosreERKZprsxBkZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("VideoBase64","AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAEDv1tZGF0AAACrgYF//+q3EXpvebZSLeWLNgg2SPu73gyNjQgLSBjb3JlIDE1MiByMjg1MSBiYTI0ODk5IC0gSC4yNjQvTVBFRy00IEFWQyBjb2RlYyAtIENvcHl……………………aGRscgAAAAAAAAAAbWRpcmFwcGwAAAAAAAAAAAAAAAAtaWxzdAAAACWpdG9vAAAAHWRhdGEAAAABAAAAAExhdmY1Ny44MS4xMDA=") .addTextPara("LivenessType","SILENT") .addTextPara("ValidateData","") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
Result String
Success
业务错误码,成功情况返回Success, 错误情况请参考下方错误码 列表中FailedOperation部分
Description String
成功
业务错误描述
BestFrameBase64 String
Imagebase64
验证通过后的视频最佳截图照片,照片为BASE64编码后的值,jpg格式。
Sim String
89.88
相似度,取值范围 [0.00, 100.00]。推荐相似度大于等于70时可判断为同一人,可根据具体场景自行调整阈值(阈值70的误通过率为千分之一,阈值80的误通过率是万分之一)。
RequestId String
f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "Result":"Success", "Description":"成功", "BestFrameBase64":"Imagebase64", "Sim":"89.88", "RequestId":"f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a" }, "remark":"调用成功!", "ret_code":0 } }

活体人脸核身


接口地址:http://route.showapi.com/1980-9 (注意:接口支持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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
IdCard String
530xxxxxxxxxxx5687
身份证号
Name String
某某某
姓名。中文请使用UTF-8编码。
VideoBase64 String
AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAEDv1tZGF0AAACrgYF
用于活体检测的视频,视频的BASE64值; BASE64编码后的大小不超过5M,支持mp4、avi、flv格式。
LivenessType String
SILENT
活体检测类型,取值:LIP/ACTION/SILENT。 LIP为数字模式,ACTION为动作模式,SILENT为静默模式,三种模式选择一种传入。
ValidateData String
数字模式传参:数字验证码(1234),需先调用接口获取数字验证码; 动作模式传参:传动作顺序(2,1 or 1,2),需先调用接口获取动作顺序; 静默模式传参:空。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-9","my_appId","my_appSecret") .addTextPara("IdCard","530xxxxxxxxxxx5687") .addTextPara("Name","某某某") .addTextPara("VideoBase64","AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAEDv1tZGF0AAACrgYF") .addTextPara("LivenessType","SILENT") .addTextPara("ValidateData","") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
Result String
Success
业务错误码,成功情况返回Success, 错误情况请参考下方错误码 列表中FailedOperation部分
Description String
成功
业务错误描述
BestFrameBase64 String
<Imagebase64>
验证通过后的视频最佳截图照片,照片为BASE64编码后的值,jpg格式。
Sim String
89.88
相似度,取值范围 [0.00, 100.00]。推荐相似度大于等于70时可判断为同一人,可根据具体场景自行调整阈值(阈值70的误通过率为千分之一,阈值80的误通过率是万分之一)
RequestId String
f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "Result":"Success", "Description":"成功", "BestFrameBase64":"<Imagebase64>", "Sim":"89.88", "RequestId":"f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a" }, "remark":"调用成功!", "ret_code":0 } }

实名核身鉴权


接口地址:http://route.showapi.com/1980-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
RuleId String
0
用于细分客户使用场景,申请开通服务后,可以在腾讯云慧眼人脸核身控制台(https://console.cloud.tencent.com/faceid) 自助接入里面创建,审核通过后即可调用。如有疑问,请加慧眼小助手微信(faceid001)进行咨询。
IdCard String
身份标识(与公安权威库比对时必须是身份证号)。 规则:a-zA-Z0-9组合。最长长度32位。
Name String
姓名。最长长度32位。中文请使用UTF-8编码。
RedirectUrl String
认证结束后重定向的回调链接地址。最长长度1024位。
Extra String
透传字段,在获取验证结果时返回。
ImageBase64 String
用于人脸比对的照片,图片的BASE64值; BASE64编码后的图片数据大小不超过3M,仅支持jpg、png格式。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-10","my_appId","my_appSecret") .addTextPara("RuleId","0") .addTextPara("IdCard","") .addTextPara("Name","") .addTextPara("RedirectUrl","") .addTextPara("Extra","") .addTextPara("ImageBase64","") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
BizToken String
CE661F1A-0F1E-45BD-BE13-34C05CEA7681
一次核身流程的标识,有效时间为7,200秒; 完成核身后,可用该标识获取验证结果信息。
Url String
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx2cca36a86d5035ae&redirect_uri=http%3A%2F%2Fopen.faceid.qq.com%2Fv1%2Fapi%2FgetCode%3FbizRedirect%3Dhttp%253A%252F%252Ffaceid.qq.com%252Fapi%252Fauth%252FgetOpenidAndSaveToken%253Ftoken%253DCE661F1A-0F1E-45BD-BE13-34C05CEA7681&response_type=code&scope=snsapi_base&state=&component_appid=wx9802ee81e68d6dee#wechat_redirect
用于发起核身流程的URL,仅微信H5场景使用。
RequestId String
f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "BizToken": "CE661F1A-0F1E-45BD-BE13-34C05CEA7681", "Url": "https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx2cca36a86d5035ae&redirect_uri=http%3A%2F%2Fopen.faceid.qq.com%2Fv1%2Fapi%2FgetCode%3FbizRedirect%3Dhttp%253A%252F%252Ffaceid.qq.com%252Fapi%252Fauth%252FgetOpenidAndSaveToken%253Ftoken%253DCE661F1A-0F1E-45BD-BE13-34C05CEA7681&response_type=code&scope=snsapi_base&state=&component_appid=wx9802ee81e68d6dee#wechat_redirect", "RequestId": "f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a" }, "remark":"调用成功!", "ret_code":0 } }

获取实名核身结果信息


接口地址:http://route.showapi.com/1980-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
BizToken String
CE661F1A-0F1E-45BD-BE13-34C05CEA7681
人脸核身流程的标识,调用DetectAuth接口时生成。
RuleId String
0
用于细分客户使用场景,申请开通服务后,可以在腾讯云慧眼人脸核身控制台(https://console.cloud.tencent.com/faceid) 自助接入里面创建,审核通过后即可调用。如有疑问,请加慧眼小助手微信(faceid001)进行咨询。
InfoType String
0
指定拉取的结果信息,取值(0:全部;1:文本类;2:身份证正反面;3:视频最佳截图照片;4:视频)。 如 134表示拉取文本类、视频最佳截图照片、视频。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1980-11","my_appId","my_appSecret") .addTextPara("BizToken","CE661F1A-0F1E-45BD-BE13-34C05CEA7681") .addTextPara("RuleId","0") .addTextPara("InfoType","0") .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数据结构): 展开收起
名称 类型 示例值 描述
Response Object
DetectInfo String
{"Text":{"ErrCode":null,"ErrMsg":null,"IdCard":"","Name":"","OcrNation":null,"OcrAddress":null,"OcrBirth":null,"OcrAuthority":null,"OcrValidDate":null,"OcrName":null,"OcrIdCard":null,"OcrGender":null,"LiveStatus":null,"LiveMsg":null,"Comparestatus":null,"Comparemsg":null,"Extra":"","Detail":{"LivenessData":[]}},"IdCardData":{"OcrFront":null,"OcrBack":null},"BestFrame":{"BestFrame":null},"VideoData":{"LivenessVideo":null}}
JSON字符串。 { // 文本类信息 "Text": { "ErrCode": null, // 本次核身最终结果。0为成功 "ErrMsg": null, // 本次核身最终结果信息描述。 "IdCard": "", // 本次核身最终获得的身份证号。 "Name": "", // 本次核身最终获得的姓名。 "OcrNation": null, // ocr阶段获取的民族 "OcrAddress": null, // ocr阶段获取的地址 "OcrBirth": null, // ocr阶段获取的出生信息 "OcrAuthority": null, // ocr阶段获取的证件签发机关 "OcrValidDate": null, // ocr阶段获取的证件有效期 "OcrName": null, // ocr阶段获取的姓名 "OcrIdCard": null, // ocr阶段获取的身份证号 "OcrGender": null, // ocr阶段获取的性别 "LiveStatus": null, // 活体检测阶段的错误码。0为成功 "LiveMsg": null, // 活体检测阶段的错误信息 "Comparestatus": null,// 一比一阶段的错误码。0为成功 "Comparemsg": null, // 一比一阶段的错误信息 "Location": null, // 地理位置信息 "Extra": "", // DetectAuth结果传进来的Extra信息 "Detail": { // 活体一比一信息详情 "LivenessData": [] } }, // 身份证正反面照片Base64 "IdCardData": { "OcrFront": null, "OcrBack": null }, // 视频最佳帧截图Base64 "BestFrame": { "BestFrame": null }, // 活体视频Base64 "VideoData": { "LivenessVideo": null } }
RequestId String
0f96cf39-a183-485c-ab29-8427ab81f9ae
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
remark String
调用成功!
ret_code Number
0
...
返回示例:{ "showapi_res_error":"", "showapi_res_id":"012a7b26c9094c40b830875139470b1e", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "DetectInfo": "{\"Text\":{\"ErrCode\":null,\"ErrMsg\":null,\"IdCard\":\"\",\"Name\":\"\",\"OcrNation\":null,\"OcrAddress\":null,\"OcrBirth\":null,\"OcrAuthority\":null,\"OcrValidDate\":null,\"OcrName\":null,\"OcrIdCard\":null,\"OcrGender\":null,\"LiveStatus\":null,\"LiveMsg\":null,\"Comparestatus\":null,\"Comparemsg\":null,\"Extra\":\"\",\"Detail\":{\"LivenessData\":[]}},\"IdCardData\":{\"OcrFront\":null,\"OcrBack\":null},\"BestFrame\":{\"BestFrame\":null},\"VideoData\":{\"LivenessVideo\":null}}", "RequestId": "0f96cf39-a183-485c-ab29-8427ab81f9ae" }, "remark":"调用成功!", "ret_code":0 } }

服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。

易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。

让开发者可以像搭积木一样通过各种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

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐