请求参数说明：
| 名称 | 必填 | 类型 | 说明 | |
|---|---|---|---|---|
| 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/1524401118 |
现在注册，百款接口免费测试
免费注册