腾讯云人脸核身·云智慧眼(FaceID)方案,是依托于证件OCR识别、活体检测、1:1人脸比对等AI技术,实现自然人真实身份核验的产品。秒级确认用户身份,帮助提升业务办理效率,降低人力成本。
人脸核身·云智慧眼为您提供了短信、OCR、活体检测、1:1人脸比对的配套服务,可根据您的需求灵活组合。
1.与权威数据库比对
2.与上传照片比对
支持识别身份证正反面,一次扫描即可返回身份证号、姓名、有效时间等所有字段,数字识别准确率达到 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_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 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_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': '服务繁忙' - 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-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