• 264
  • 2318
  • 23

人脸对比

聚合数据 支持HTTPS

对上传的图片与库中的实际身份证照片进行比对

  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用
接口地址:http://apis.juhe.cn/verifyface/verify
返回格式:json
请求方式:http post
请求示例:http://apis.juhe.cn/verifyface/verify
接口备注:按格式提交1张人脸图片与身份证库中图片进行对比,返回相似度评分,人脸图像1M以内,jpg格式,最长边像素为800pi最佳

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  idcard string 身份证号
  realname string 姓名
  image string 人脸图片base64编码内容(不包含data:image/jpg;base64,)大小1M以内
 

返回参数说明:

名称 类型 说明
  error_code int 返回码,0或226402计费一次;当返回226403时表示参数错误,部分英文对应说明为:INVALID_IMAGE_SIZE: image=图像太大;NO_FACE_FOUND: image=未检测到人脸;LOW_QUALITY=图像质量低;IMAGE_ERROR_UNSUPPORTED_FORMAT: image=图像无法正确解析
  reason string 返回说明
  result json 返回数据
  message string 识别说明
  res int 比对结果,1:身份证号与姓名匹配,且比对成功 (注释:表示姓名、ID号与官方一致,且上传的照片与底库照片比对成功,仅表示两张照片比对成功,也可以理解两张照片中都检测到了人脸,是否认定为本人,需参考score的值,越高表示匹配度越高)2:身份证核查成功,但人脸比对失败;3:身份证号与姓名不匹配
  score string 比对分值(res为1时存在,0~100之间)
  code string res为2时存在,3003,3004,3005,说明参照desc
  desc string res为2时存在,3003对应人脸库中的照片检测不到人脸;3004对应用户上传的照片检测不到人脸;3005对应人脸比对失败
 

JSON返回示例:

/*注意事项:*/
由于人脸比对过程中,涉及到图片预处理,人脸识别,特征提取,算法比对等,所以对于用户所上传身份证正面照片有所规范,如下:
(1)采集相片为JPG等常用Windows平台相片格式;
(2)照片像素不宜太低,人脸像素不得小于128*128,大小1M以内;
(3)身份证翻拍照,请勿反光、污损、模糊或梯度变形;
(4)照片请勿强曝光,逆光,背光等;
(5)照片请勿出现人脸遮挡(饰物、头发等),勿戴口罩、墨镜;
(6)照片请勿人为拉伸、压缩(人脸图片变形,影响比对效果);
(7)身份证照片中无特殊复杂背景。




/*返回示例1*/
{
    "reason": "成功",
    "result":{
        "res": 1,
        "score": "96.129906",
        "message": "身份证号与姓名匹配,且比对成功",
        "orderid": "JH264117091113513280159458"
    },
    "error_code": 0
}
/*返回示例2*/
{
    "reason":"成功",
    "result":{
        "res": 2,
        "code":"3004",
        "message": "身份证核查成功,但人脸比对失败",
        "desc":"用户上传的照片检测不到人脸"
        "orderid": "JH264117091113492036501983"
    },
    "error_code": 0
}
/*返回示例3*/
{
    "reason":"成功",
    "result":{
        "res": 3,
        "message": "身份证号与姓名不匹配",
        "orderid": "JH264117091113492036501983"
    },
    "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明

系统级错误码参照:

  错误码 说明 旧版本(resultcode)

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1547811872

联系我们

  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 400-882-7715
  在线客服QQ: 800076065

现在注册,百款接口免费测试

免费注册