接入文档
FaceID基础版
计费状态码
计费状态码
# 1 APP接入方式计费状态码
# 1.1 FaceID基础版(V3-SDK)计费状态码
结果状态码(result_code) | 返回信息(result_message) | 含义解释 | 是否计费 |
---|---|---|---|
1000 | SUCCESS | 活体验证通过,比对通过 | 是 |
2000 | PASS_LIVING_NOT_THE_SAME | 活体验证通过,比对失败 | 是 |
3000 | NO_ID_CARD_NUMBER | 参考数据错误,可能原因:无此身份证号、照片格式错误、照片中找不到人脸等可能 | 是 |
3000 | ID_NUMBER_NAME_NOT_MATCH | 证件号码和姓名不匹配 | 是 |
3000 | NO_FACE_FOUND | 参考数据错误,可能原因:无此身份证号、照片格式错误、照片中找不到人脸等可能 | 是 |
3000 | NO_ID_PHOTO | 参考数据错误,可能原因:无此身份证号、照片格式错误、照片中找不到人脸等可能 | 是 |
3000 | PHOTO_FORMAT_ERROR | 参考数据错误,可能原因:无此身份证号、照片格式错误、照片中找不到人脸等可能 | 是 |
# 1.2 FaceID基础版(V2-SDK)计费状态码
HTTP状态码 | 返回信息(error_message) | 含义解释 | 是否计费 |
---|---|---|---|
400 | IMAGE_ERROR_UNSUPPORTED _FORMAT |
参数对应的图像无法正确解析,有可能不是一个图像文件、或有数据破损 ●当取值为data_source时,表示参考数据返回的图片无法解析、或者没有照片。注意:这对应Verify 1.0 API里的错误码 400(IDCARD_NO_PHOTO) |
是 |
400 | NO_FACE_FOUND | 从参考图像、用户传递的image图像,或是用户传递image_ref图像中没有找到人脸。请注意:只会有一项,即第一个满足条件的名称 ● 当KYC验证时,如果参考数据没有指定人的图像、或者图像里没有检测到人脸,参数值为data_source |
是 |
400 | NO_SUCH_ID_NUMBER | KYC验证时,参考数据中没有此证件号码的记录 | 是 |
400 | ID_NUMBER_NAME_NOT_MATCH | KYC验证时,参考数据中存在此证件号码,但与提供的姓名不匹配 | 是 |
# 2 H5接入方式计费状态码
H5产品在活体结束会计费,对账时可通过比对结果接口(get_result)来获取计费状态码
HTTP状态码 | 返回信息(verify_result的error_message) | 含义解释 | 是否计费 |
---|---|---|---|
200 | NULL | 没有错误 | 是 |
200 | NO_SUCH_ID_NUMBER | 没有此身份证号码的记录 | 是 |
200 | ID_NUMBER_NAME_NOT_MATCH | 身份证号码与提供的姓名不匹配 | 是 |
200 | IMAGE_ERROR_UNSUPPORTED_FORMAT | 姓名和身份证号正确,但图片无法解析或者没有可比对图片 | 是 |
200 | NO_FACE_FOUND | 对应的图像没有检测到人脸 | 是 |
200 | DATA_SOURCE_ERROR | 调用比对数据发生错误,一般来说是数据出错 | 否 |
200 | INTERNAL_ERROR | 服务器内部错误,当此类错误发生时请再次请求 | 否 |
HTTP状态码 | 返回信息(error_message) | 含义解释 | 是否计费 |
---|---|---|---|
400 | RESULT_NOT_FOUND | 此错误类型表示传入的业务编号错误 | 否 |
400 | VIDEO_FACE_OCCLUDE | 上传的视频中人脸被遮挡 | 否 |
403 | AUTHENTICATION_ERROR | api_key和api_secret不匹配 | 否 |
403 | AUTHORIZATION_ERROR | api_key被停用、调用次数超限、没有调用此API的权限,或者没有以当前方式调用此API的权限。目前的< reason >有:Denied. (没有权限调用当前API) | 否 |
403 | CONCURRENCY_LIMIT_EXCEEDED | 并发数超过限制 | 否 |
400 | MISSING_ARGUMENTS | 缺少某个必选参数 | 否 |
403 | DATA_DESTROYED | 超过可查询时间或超过最多可查询次数 | 否 |
400 | BAD_ARGUMENTS | 某个参数解析出错(比如必须是数字,但是输入的是非数字字符串; 或者长度过长,etc.) | 否 |
404 | API_NOT_FOUND | 所调用的API不存在 | 否 |
500 | INTERNAL_ERROR | 服务器内部错误,当此类错误发生时请再次请求,如果持续出现此类错误,请及时联系FaceID客服或商务 | 否 |
# 3 PC接入方式计费状态码
HTTP状态码 | 返回信息(VERIFY_API_FAILED) | 含义解释 | 是否计费 |
---|---|---|---|
400 | NO_FACE_FOUND | 姓名和身份证号码正确,但照片没有检测到人脸 | 是 |
400 | NO_SUCH_ID_NUMBER | 没有此身份证号码的记录。此错误会产生计费 | 是 |
400 | ID_NUMBER_NAME_NOT_MATCH | 身份证号码与提供的姓名不匹配。此错误会产生计费 | 是 |
400 | IMAGE_ERROR_UNSUPPORTED_FORMAT | 姓名和身份证号正确,但图片无法解析或者没有可比对图片。此错误会产生计费 | 是 |
# 4 RAW纯接口接入方式计费状态码
HTTP状态码 | 返回信息(VERIFY_API_FAILED) | 含义解释 | 是否计费 |
---|---|---|---|
400 | NO_FACE_FOUND | 姓名和身份证号码正确,但照片没有检测到人脸 | 是 |
400 | NO_SUCH_ID_NUMBER | 没有此身份证号码的记录。此错误会产生计费 | 是 |
400 | ID_NUMBER_NAME_NOT_MATCH | 身份证号码与提供的姓名不匹配。此错误会产生计费 | 是 |
400 | IMAGE_ERROR_UNSUPPORTED_FORMAT | 姓名和身份证号正确,但图片无法解析或者没有可比对图片。此错误会产生计费 | 是 |
该文档未解决您的疑问?
查看常见问题