服务端错误码

更新时间:
复制 MD 格式

适用API

Code

Message

描述

通用

200

success

成功。

通用

400

参数不能为空

参数不能为空。

通用

401

参数非法

传入参数不符合要求。

通用

402

  • 权威源服务异常

  • 安全策略限制

  • 无权限调用

  • 权威源服务异常。

  • 控制台配置的安全性规则拦截,具体信息,请参见安全管理

  • 无权限调用。

通用

403

异常重复调⽤

异常重复调用次数超限。

  • 手机号三要素简版

  • 手机号三要素详版

  • 手机号二要素

405

手机号不可查询

手机号不可查询,不支持的号段。

  • 身份二要素核验(支持OCR)

  • 身份三要素核验

  • 凭证核验服务

  • 人脸Deepfake检测

405

图片格式不正确

图片格式不正确或大小不符合要求。

人脸Deepfake检测

406

检测不到人脸

检测不到人脸。

通用

410

未开通服务

产品未开通。

通用

411

RAM无权限

RAM用户无权限,请授权AliyunYundunCloudAuthFullAccess

通用

412

欠费中

产品欠费,请充值后操作。

  • 身份二要素核验(支持OCR)

  • 身份三要素核验

  • 凭证核验服务

  • 人脸Deepfake检测

419

数据重复

  • 身份二要素核验(支持OCR):同时传入CertUrlCertFileObject

  • 身份三要素核验:同时传入FacetUrlFaceFileObject

  • 凭证核验服务:同时传入imageUrlimageContext参数。

  • 人脸Deepfake:同时传入faceUrlfaceBase64参数。

  • 身份二要素核验(支持OCR)

  • 身份三要素核验

  • 凭证核验服务

  • 人脸Deepfake检测

420

传入图片不可用

传入图片不可用。

  • 身份二要素核验(支持OCR)

  • 身份三要素核验

  • 凭证核验服务

  • 人脸Deepfake检测

421

传入图片过大

传入图片过大。

  • 身份二要素核验(支持OCR)

    • 纯服务端接入

    • DescribeCardVerify
  • 身份三要素核验

    • DescribeCardVerify

440

OCR识别失败

OCR识别失败。

请检查输入图片内容,保证照片清晰、曝光正常,完整无遮挡,角度无太大偏差。

通用

500

系统错误

系统内部错误。

身份三要素核验SubCode

适用于API

SubCode

Message

可能原因和处理建议

身份三要素

101

认证通过

调用成功。

201

认证不通过,姓名与身份证号不匹配

可能是用户的信息有误或用户的信息为假信息,建议用户确认后重新操作。

202

认证不通过,疑似本人

可能人像变化较大或照片质量不佳,建议预留人审入口或重新上传照片。

203

认证不通过,库中无照片

可能是权威源数据问题导致,建议预留人工审核入口,进行人工审核。

204

认证不通过,非同一人

可能不是同一人或照片质量较低,建议根据业务情况分层处理,若为同一人可重新操作。

205

认证不通过,待比对图像建模失败

可能是人像照片质量过差,导致人脸检测或特征提取算法无法完成建模,建议用户重新拍摄,确保正面、光线均匀、人脸清晰可见。

206

认证不通过,图片格式不正确

上传的图片文件格式不在系统支持范围内,建议将图片转换为常见的 JPG 或 PNG 格式后重新上传。

207

认证不通过,上传图片太小,请重新上传

上传图片的分辨率或文件尺寸低于系统最低要求。建议上传更高分辨率的图片,并确保人脸区域有足够的像素细节。

208

认证不通过,上传的人像照片质量不佳,请重新上传

整体质量不达标,可能涉及模糊、噪点多、压缩过度、人脸遮挡等问题。建议重新上传一张清晰、正面、无遮挡的人像照片。

301

查无记录,库中无此号

权威数据源中不存在该身份证号码,建议用户核对身份证号码是否正确,确认无误后如仍返回此结果,可能是权威源数据覆盖问题,建议预留人工审核入口。

302

查无记录,无法验证

可能是权威源接口超时、数据源临时不可用、或该身份信息在权威源中状态异常,建议用户稍后重试,若持续出现则引导至人工审核