• 264
  • 1869
  • 18

人脸对比

聚合数据 支持HTTPS

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

  • 1
  • 10000
  • 1000
  • 100

¥0.50 (约元/次)每人最多限购10份;

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

请求参数说明:

名称 必填 类型 说明
  key string 您申请的key
  idcard string 身份证号
  realname string 姓名
  image string 人脸图片base64编码内容(不包含data:image/jpg;base64,)
 

返回参数说明:

名称 类型 说明
  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;
(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):

  错误码 说明
  226401 数据源超时
  226402 查无记录(计费)
  226403 参数错误
  226404 数据源错误

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

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

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

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

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

联系我们

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

猜你喜欢

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

免费注册