/face/v2/verify_selfie_idnumber_lite

1.接口描述

该API提供通过身份证号、姓名和⾃拍照去第三方进⾏身份验证功能,返回是否为同一个⼈

  • 图片要求

    1. 格式为 JPG(JPEG),BMP,PNG,GIF,TIFF
    2. 宽和高大于 128px,小于等于4000px
    3. 小于等于 5 MB
  • 支持自动识别人脸方向

    1. 上传的图片中包含有 exif 方向信息,先按此信息旋转、翻转后再做识别人脸方向并调整。
    2. 如果照片方向混乱且 exif 方向信息不存在或不正确,自动识别人脸方向并调整

请求方式:

POST

请求URL:

http://cloudapi.deepfinch.com/face/v2/verify_selfie_idnumber_lite

调试工具

Debugging Tool

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 , urlimage_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_coderesult_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"
}

5.输入示例

results matching ""

    No results matching ""