人脸实名认证2.0

企业专用

官 稳 保
  • 接口文档

    接口文档
  • 人脸实名认证2.0

  • 错误码
  • 错误码列表
  • 资源下载
  • 接口文档下载
人脸实名认证2.0
接口地址:https://apis.juhe.cn/simple-faceid/verify
请求方式:http post
返回类型:json
接口描述:按格式提交1张人脸图片与身份证库中图片进行对比,返回是否通过,人脸图像大小最佳在16~20K之间,jpeg格式,最长边像素为800pi最佳
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  idcard string 身份证号
  realname string 姓名
  image string 人脸图片base64编码内容
提示 图片内容不含data:image/jpg;base64,前缀,大小最佳在16~20K之间

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i -d "key=key&idcard=xxx&realname=xxx&image=xxx" "https://apis.juhe.cn/simple-faceid/verify"

返回参数说明:

名称 类型 说明
  error_code int 返回码,0计费一次
  reason string 返回说明
  result object 返回数据
  message string 识别说明
  res int 比对结果,
1:身份证号与姓名匹配,人脸比对通过
2:身份证号与姓名匹配,人脸比对未通过
3:身份证号与姓名不匹配
4:身份证号与姓名匹配,人脸库中的照片检测不到人脸
5:身份证号与姓名匹配,人脸比对失败

其他使用说明:

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

JSON返回示例:JSON在线格式化工具 >

      // 返回示例1 
{
    "reason": "成功",
    "result":{
        "res": 1,
        "message": "身份证号与姓名匹配,人脸比对通过",
        "orderid": "JH848117091113513280159458"
    },
    "error_code": 0
}

// 返回示例2
{
    "reason":"成功",
    "result":{
        "res": 2,
        "message": "身份证号与姓名匹配,人脸比对未通过",
        "orderid": "JH848117091113492036501983"
    },
    "error_code": 0
}

//返回示例3
{
    "reason":"成功",
    "result":{
        "res": 3,
        "message": "身份证号与姓名不匹配",
        "orderid": "JH848117091113492036501983"
    },
    "error_code": 0
}
//返回示例4
{
    "reason":"成功",
    "result":{
        "res": 4,
        "message": "身份证号与姓名匹配,人脸库中的照片检测不到人脸",
        "orderid": "JH848117091113492036501983"
    },
    "error_code": 0
}
//返回示例5
{
    "reason":"成功",
    "result":{
        "res": 5,
        "message": "身份证号与姓名匹配,人脸比对失败",
        "orderid": "JH848117091113492036501983"
    },
    "error_code": 0
}

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

  错误码 说明
  284801 数据源超时
  284802
参数错误
参数错误(姓名格式不正确)
参数错误(身份证号码格式不正确)
参数错误(图片为空)
参数错误(图片过大)
  284803 对比失败

系统级错误码参照:

  错误码 说明 旧版本(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) 具体错误代码
人脸实名认证2.0
0
申请次数
848
ID
0
收藏次数

推荐API

  • 人脸实名认证

    校验姓名、身份证号、人脸图片信息是否一致,进行人脸实名认证。
  • 活体人脸实名认证H5版

    本服务搭载真人检测和人脸比对等生物识别技术,配合权威数据源验证,可快速校验自然人的真实身份。支持PC和移动端H5网页接入,暂不支持小程序接入。
  • 人脸四要素

    根据给定的手机号、姓名、身份证、人像图片核验是否一致
  • IPv6地址

    根据查询的IPvb地址,查询该IPv6所属的区域,城市级查询。
  • 2026美加墨世界杯

    2026美加墨世界杯小组赛、1/16决赛、1/8决赛、1/4决赛、半决赛、季军赛、决赛赛程及积分榜

API资讯

数 据 驱 动 未 来
Data Drives The Future
0512-88869195
客服微信二维码

微信扫码,咨询客服

数 据 驱 动 未 来
Data Drives The Future