SDK返回的内容包括错误码和服务端认证返回数据。
错误码10000以下为客户端返回，10000及以上为服务端返回。
| erroCode | 错误码说明 |
|---|---|
| 0 | 成功 |
| -1000 | 网络异常，请稍后再试 |
| -1001 | 未知错误 |
| -1002 | 活体中断 |
| -1003 | 活体识别失败，请再试一次 |
| -1004 | 算法初始化失败 |
| -1005 | 活体参数设置失败 |
| -1006 | 用户取消操作 |
| -1007 | 用户取消证件识别 |
| -1101 | 超过活体最大次数 |
| -3001 | 网络数据包解析失败 |
| -3003 | 无法使用相机，请检查是否打开相机权限 |
| -3006 | 相册图片获取失败 |
| -3007 | 拍照失败 |
| -5021 | 比对失败，请确认是本人 |
| 10000+ | 10000以上为透传服务端的错误码 |
| erroCode | 错误码说明 |
|---|---|
| 50200 | 参数错误 |
| 50201 | 缺少参数 |
| 50204 | 参数类型错误/参数缺失 |
| 50205 | 图像尺寸超过限制。输入为图片时可能返回此错误。 |
| 50206 | 请求参数中没有获取到图像。输入为图片时可能返回此错误。 |
| 50207 | 图像解码错误。输入为图片时可能返回此错误。 |
| 50209 | 请求参数中没有获取到视频。输入为视频时可能返回此错误。 |
| 50210 | 视频解码错误。输入为视频时可能返回此错误。 |
| 50211 | 视频尺寸超过限制。输入为视频时可能返回此错误。 |
| 50213 | 请求Body过大，超过10MB限制。 |
| 50214 | 输入视频时长过大 |
| 50215 | 请查看认证子错误码了解具体含义。认证子错误码说明见下方。 |
| 60102 | 算法服务需要输入人脸图，但未检测到 |
| 50400 | 权限校验失败，没有接口权限/时间戳参数不正确/签名字段错误。 |
| 50402 | 访问的接口不存在。 |
| 50429 | 超过调用QPS限制。 |
| 50500 | 服务器内部错误。 |
| 50501 | 服务器内部RPC错误。 |
jsonData中包含服务端返回数据。jsonData为json字符串，需要先解析为对象再获取内容。格式如下：
字段名 | 类型 | 必选/可选 | 说明 | 备注 |
|---|---|---|---|---|
result | bool | 必选 | 是否核验通过 | |
images | json | 必选 | 客户端采集的人脸图 | |
source_comp_details | json | 有源比对时必选 | 数据源认证的分数和阈值 | |
algorithm_base_resp | json | 可选 | 认证子错误说明，可以进一步区分错误原因，部分服务异常情况时无法返回。 | |
req_measure_info | bool | 可选 | 计费说明，部分服务异常情况时无法返回。 |
字段名 | 类型 | 必选/可选 | 说明 | 备注 |
|---|---|---|---|---|
image_face | string | 必选 | 人脸图的base64 | |
image_env | string | 必选 | 环境图的base64 |
字段名 | 类型 | 必选/可选 | 说明 | 备注 |
|---|---|---|---|---|
score | float64 | 必选 | 有源比对分数 | |
thresholds | json | 必选 | 有源比对分数阈值 |
注意：阈值不是静态的，每次比对返回的阈值不保证相同，因此没有持久化存储的必要，更不要拿本次分数和前一次阈值进行比较。
字段名 | 类型 | 必选/可选 | 说明 | 备注 |
|---|---|---|---|---|
1e-3 | float64 | 必选 | 0.1%置信度阈值 | |
1e-4 | float64 | 必选 | 0.01%置信度阈值 | |
1e-5 | float64 | 必选 | 0.001%置信度阈值 | |
1e-6 | float64 | 必选 | 0.0001%置信度阈值 |
字段名 | 类型 | 必选/可选 | 说明 | 备注 |
|---|---|---|---|---|
status_code | int | 必选 | 认证子错误码 | 详细见： 错误码和计费 |
status_message | string | 必选 | 子错误描述 |
字段名 | 类型 | 必选/可选 | 说明 | 备注 |
|---|---|---|---|---|
measure_type | string | 必选 | 取值固定为"query_num" | |
value | int | 必选 | 取值为0或1。0为不计费，1为计费。 | 需要计费的子错误码见： 错误码和计费 |