实人认证开发指南：用API+深度学习构建人证合一系统
在数字化时代，身份验证和实人认证变得尤为重要，尤其是在金融、政务、安防等领域。**万维易源提供的“实人认证_人像比对”API接口，能够通过姓名和身份证号结合人像比对的方式，实现高效且准确的实人认证。**本文将详细介绍如何使用这个API接口。
一、API概述
1、接入点说明（以“身份证二要素人像比对”为例）
- 照片字段注意说明：
- 支持 jpg、jpeg、bmp、png 格式。
- 照片为生活照，图片大小范围在 0-30KB 以内。
- 照片像素不宜太低。
- 照片请勿反光、污损、模糊或梯度变形。
- 照片请勿强曝光、逆光、背光等。
- 照片请勿出现人脸遮挡（头饰、头发等），勿带口罩、墨镜。
2、接口地址
https://route.showapi.com/2668-4?appKey={your_appKey}
请将 {your_appKey} 替换为你在万维易源平台申请的个人 appKey。
二、请求参数说明
以下是提交身份验证信息所需的请求参数：
| 参数名称 | 类型 | 示例值 | 必须 | 描述 |
|---|---|---|---|---|
| name | String | 金阳 | 是 | 姓名，测试时注意不要填错，填错一样扣减使用次数 |
| idcard | String | 11010219781027232x | 是 | 身份证号，测试时注意不要填错，填错一样扣减使用次数 |
| photo | String | /9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKD… | 是 | BASE64人像图片 |
三、返回参数
以下是接口返回的参数及其描述：
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| birthday | String | 1991-11-04 | 生日 |
| ret_code | Number | 0 | 0为成功，计费，其余为失败，不计费 |
| sex | String | F | 性别：M为男性，F为女性 |
| order | String | 145801957588529905 | 相关流水号 |
| county | String | 清徐县 | 区县 |
| address | String | 山西太原市清徐县 | 详细地址 |
| province | String | 山西省 | 省 |
| code | Number | 0 | 验证标示： |
- 0：匹配
- 1：不匹配
- 2：无此身份证号码
- 3：身份证号与姓名匹配，照片比对失败
- 4：参数不能为空
- 5：四要素匹配成功，照片比对失败
- 6：四要素匹配失败，照片比对成功
- 7: 四要素匹配成功，照片异常
- 8：身份证号与姓名匹配，照片不能确定是否为同一人
- 9：身份证号与姓名匹配，库中无照片
- 10：身份证号与姓名匹配，照片检测失败
- 12：身份证号码不合法
- 13: 照片质量异常
- 14: 姓名异常
- 15: 暂不支持该地域校验
- 100：渠道异常，请稍后再试
- 101：验证信息重复输入，避免恶意验证请间隔60秒以上再次核验
- 103：24小时内相同姓名或卡号核验次数超限
- 104：decrypt参数异常
- 202：姓名加密信息有误，请检查
- 203：身份证加密信息有误，请检查
- 205：开始时间加密信息有误，请检查
- 206：结束时间加密信息有误，请检查
- 207：人像照片加密信息有误，请检查 |
| msg | String | 匹配 | 说明 |
| city | String | 太原市 | 城市 |
| score | Number | 90 | 置信度 |
四、调用示例
以下是使用curl命令调用该API接口的示例：
curl 'https://route.showapi.com/2668-4?appKey=your_appKey' \-H 'Content-Type: application/x-www-form-urlencoded' \-d 'photo=%2F9j%2F4AAQSkZJRgABAQEAYABgAAD%2F2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKD...%E5%B7%B2%E7%9C%81%E7%95%A5' \-d 'name=%E9%87%91%E9%98%B3' \-d 'idcard=11010219781027232x'
请将 your_appKey 替换为你在万维易源平台申请的 appKey。
五、返回示例
调用成功后，接口会返回如下格式的JSON数据：
{"showapi_res_error": "","showapi_res_code": 0,"showapi_res_id": "60d2da870de3769d4d2df7b4","showapi_res_body": {"birthday": "1991-11-04","ret_code": 0,"sex": "F","order": "145801957588529905","county": "清徐县","address": "山西太原市清徐县","province": "山西省","code": 0,"msg": "匹配","city": "太原市","score": 90}
}
六、注意事项
- 获取AppKey：在调用接口之前，需要先在万维易源官网注册并获取你的
appKey。 - 照片质量：请确保上传的照片符合接口要求，避免因照片质量问题导致比对失败。
- 频率限制：请注意接口的调用频率限制，避免因频繁调用导致服务不可用。
- 数据隐私：在使用该接口时，务必遵守相关法律法规，保护用户隐私。
七、总结
**万维易源的“实人认证_身份证人像比对”API接口为开发者提供了一个高效、便捷的身份验证工具，能够快速实现姓名、身份证号与人像的比对，确保实人认证的准确性和安全性。通过简单的参数配置和调用，即可实现复杂的身份验证任务，大大提高了开发效率。**希望本文的介绍对你有所帮助，如果你有任何疑问或需要进一步的帮助，欢迎随时留言交流。