/face/v2/verify_selfie_idnumber
1.接口描述
该API提供通过身份证号、姓名和⾃拍照去第三方进⾏身份验证功能,返回是否为同一个⼈
图片要求
- 格式为 JPG(JPEG),BMP,PNG,GIF,TIFF
- 宽和高大于 128px,小于等于4000px
- 小于等于 5 MB
支持自动识别人脸方向
- 上传的图片中包含有 exif 方向信息,先按此信息旋转、翻转后再做识别人脸方向并调整。
- 如果照片方向混乱且 exif 方向信息不存在或不正确,自动识别人脸方向并调整
请求方式:
POST
请求URL:
http://cloudapi.deepfinch.com/face/v2/verify_selfie_idnumber
调试工具
2.请求参数
2.1 请求头域
字段 | 类型 | 必需 | 描述 |
---|---|---|---|
X-DF-API-ID | string | 是 | API调用凭证信息,详细信息请参考API调用 |
X-DF-API-SECRET | string | 是 | API调用凭证信息,详细信息请参考API调用 |
2.2 请求体
字段 | 类型 | 必需 | 描述 |
---|---|---|---|
file | file | 见下方注释 | 人脸图片文件,本地上传选取此参数 |
url | string | 见下方注释 | 人脸图片的url,从网络获取时选取此参数 |
image_base64 | string | 见下方注释 | 人脸图片的base64编码 |
id_number | string | 是 | 身份证号。用以查询公安部后台预留照片 |
name | string | 是 | 与身份证号相对应的姓名 |
注释:
请求参数
file
,url
与image_base64
三选一。参数
file
需把图片文件以 multipart/form-data 的形式放到 POST 消息体中。
3.返回参数
正常响应 (200
)
字段 | 类型 | 描述 |
---|---|---|
request_id | string | 本次请求的 id |
status | string | 状态。正常为 OK ,其他值表示失败。详见错误码 |
score | int | 人脸比对分数,仅供参考 |
result_code | int | 认证结果码 |
result_message | string | 认证结果描述 |
备注:分数推荐值范围供参考,可根据各自风险策略稍微调高或调低。
[0,39]不同人; [40,44]不能确定是否为同一人; [45,100]确定为同一人;
其中result_code
和result_message
的字段如下:
result_code | result_message | 描述 | 计费 |
---|---|---|---|
1001 | 系统判断为同一人 | 身份证号与姓名匹配,人脸判断为同一人 | 计费 |
1002 | 不能确定是否为同一人 | 身份证号与姓名匹配,人脸不能确定为同一人 | 计费 |
1003 | 系统判断为不同人 | 身份证号与姓名匹配,人脸判断为不同人 | 计费 |
2001 | 库中无照片 | 身份证号与姓名匹配,照片比对失败 | 计费 |
3001 | 身份证号与姓名不匹配 | 身份证号与姓名不匹配 | 计费 |
3002 | 库中无此号 | 未查询到此身份证号 | 不计费 |
4001 | 上传相片质量校验不合格,请重新拍摄上传 | 图片质量不合格,一般为图像中人脸图像不清晰、像素太低、照片反光或逆光,像素建议双眼间距不小于30像素,最好90像素以上 | 不计费 |
4002 | 特征提取失败 | 库中预留的照片人脸特征提取失败,无法验证 | 计费 |
4003 | 检测到多于一张人脸 | 图片检测多张人脸 | 不计费 |
4004 | 照片base64编码异常 | 库中照片base64编码异常,无法验证 | 计费 |
库无的情况可能原因为:
(1)做过户口迁移,新迁入的户籍信息,系统数据尚未更新; (2)现役军人, 系统没有存储军人信息; (3)刚退役的军人,新办理的户口及身份证还未更新到系统; (4)刚上大学或者刚毕业的大学生,迁移了户口,信息还未更新; (5)身份证过期未办理,或新办理的身份证数据库还未更新;
输出示例:
{
"status": "OK",
"request_id": "TID78792d84bebb44e794a3aeea1b9ff750",
"score": "66",
"result_code": 1001,
"result_message": "系统判断为同一人",
"selfie_image_id": "681cf14e5ef849909f5105d881f23ca4"
}
4.错误码
状态码 | status 字段 |
说明 |
---|---|---|
400 |
INVALID_ARGUMENT | 请求参数错误 |
400 |
DETETION_FAILED | 图片检测失败 |
400 |
DOWNLOAD_ERROR | 网络地址图片获取失败 |
401 |
UNAUTHORIZED | 未授权或授权失败 |
401 |
KEY_EXPIRED | 账号过期 |
403 |
NO_PERMISSION | 无调用权限 |
403 |
OUT_OF_QUOTA | 调用次数超出限额 |
403 |
RATE_LIMIT_EXCEEDED | 调用频率超出限额 |
404 |
NOT_FOUND | 请求路径错误 |
500 |
INTERNAL_ERROR | 服务器内部错误 |
输出示例:
{
"status": "DOWNLOAD_TIMEOUT",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}