身份证三要素比对 - Datawiselab公有云API文档

请求参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location 'https://cloudapi.datawiselab.com/face/v2/verify_selfie_idnumber' \
--header 'X-DF-API-ID;' \
--header 'X-DF-API-SECRET;' \
--form 'file=@""' \
--form 'url=""' \
--form 'image_base64=""' \
--form 'id_number=""' \
--form 'name=""'

返回响应

🟢200成功

application/json

分数推荐值范围供参考，可根据各自风险策略稍微调高或调低。

[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）身份证过期未办理，或新办理的身份证数据库还未更新；

Bodyapplication/json

示例

一致id/name不匹配照片比对不通过

{
    "status": "OK",
    "result_code": 1001,
    "result_message": "系统判断为同一人",
    "score": 95,
    "request_id": "TID1026083136dd4437b9167ca8835ff006",
    "selfie_image_id": "7976a7cbc6c5443fb8e738292f647040"
}