功能说明
如果返回结果中存在 Error 字段,则表示调用 API 接口失败。例如:
{
"Response": {
"Error": {
"Code": "AuthFailure.SignatureFailure",
"Message": "The provided credentials could not be validated. Please check your signature is correct."
},
"RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6"
}
}
Error 中的 Code 表示错误码,Message 表示该错误的具体信息。
错误码列表
公共错误码
错误码 | 说明 |
---|---|
ActionOffline | 接口已下线。 |
AuthFailure.InvalidAuthorization | 请求头部的 Authorization 不符合腾讯云标准。 |
AuthFailure.InvalidSecretId | 密钥非法(不是云 API 密钥类型)。 |
AuthFailure.MFAFailure | MFA 错误。 |
AuthFailure.SecretIdNotFound | 密钥不存在。请在 控制台 检查密钥是否已被删除或者禁用,如状态正常,请检查密钥是否填写正确,注意前后不得有空格。 |
AuthFailure.SignatureExpire | 签名过期。Timestamp 和服务器时间相差不得超过五分钟,请检查本地时间是否和标准时间同步。 |
AuthFailure.SignatureFailure | 签名错误。签名计算错误,请对照调用方式中的签名方法文档检查签名计算过程。 |
AuthFailure.TokenFailure | token 错误。 |
AuthFailure.UnauthorizedOperation | 请求未授权。请参考 CAM 文档对鉴权的说明。 |
DryRunOperation | DryRun 操作,代表请求将会是成功的,只是多传了 DryRun 参数。 |
FailedOperation | 操作失败。 |
InternalError | 内部错误。 |
InvalidAction | 接口不存在。 |
InvalidParameter | 参数错误(包括参数格式、类型等错误)。 |
InvalidParameterValue | 参数取值错误。 |
InvalidRequest | 请求 body 的 multipart 格式错误。 |
IpInBlacklist | IP地址在黑名单中。 |
IpNotInWhitelist | IP地址不在白名单中。 |
LimitExceeded | 超过配额限制。 |
MissingParameter | 缺少参数。 |
NoSuchProduct | 产品不存在 |
NoSuchVersion | 接口版本不存在。 |
RequestLimitExceeded | 请求的次数超过了频率限制。 |
RequestLimitExceeded.GlobalRegionUinLimitExceeded | 主账号超过频率限制。 |
RequestLimitExceeded.IPLimitExceeded | IP限频。 |
RequestLimitExceeded.UinLimitExceeded | 主账号限频。 |
RequestSizeLimitExceeded | 请求包超过限制大小。 |
ResourceInUse | 资源被占用。 |
ResourceInsufficient | 资源不足。 |
ResourceNotFound | 资源不存在。 |
ResourceUnavailable | 资源不可用。 |
ResponseSizeLimitExceeded | 返回包超过限制大小。 |
ServiceUnavailable | 当前服务暂时不可用。 |
UnauthorizedOperation | 未授权操作。 |
UnknownParameter | 未知参数错误,用户多传未定义的参数会导致错误。 |
UnsupportedOperation | 操作不支持。 |
UnsupportedProtocol | http(s) 请求协议错误,只支持 GET 和 POST 请求。 |
UnsupportedRegion | 接口不支持所传地域。 |
业务错误码
错误码 | 说明 |
---|---|
FailedOperation.ActionCloseEye | 未检测到闭眼动作。 |
FailedOperation.ActionFaceClose | 脸离屏幕太近。 |
FailedOperation.ActionFaceFar | 脸离屏幕太远。 |
FailedOperation.ActionFaceLeft | 脸离屏幕太左。 |
FailedOperation.ActionFaceRight | 脸离屏幕太右。 |
FailedOperation.ActionFirstAction | 未检测到动作配合。 |
FailedOperation.ActionLightDark | 光线太暗。 |
FailedOperation.ActionLightStrong | 光线太强。 |
FailedOperation.ActionNodetectFace | 未能检测到完整人脸。 |
FailedOperation.ActionOpenMouth | 未检测到张嘴动作。 |
FailedOperation.CompareFail | 比对失败。 |
FailedOperation.CompareLibServiceUnavailable | 比对库源维护中,暂时不可用 |
FailedOperation.CompareLowSimilarity | 比对相似度未达到通过标准。 |
FailedOperation.CompareSystemError | 调用比对引擎接口出错。 |
FailedOperation.CoveredFace | 图中人脸存在遮挡,请传入无遮挡人脸图片 |
FailedOperation.DbError | 数据库异常。 |
FailedOperation.DecryptSystemError | 解密失败。 |
FailedOperation.DetectEngineSystemError | 服务引擎调用失败,请重试 |
FailedOperation.DownLoadError | 文件下载失败。 |
FailedOperation.DownLoadTimeoutError | 文件下载超时。 |
FailedOperation.EmptyImageError | 图片内容为空。 |
FailedOperation.EncryptSystemError | 加密失败。 |
FailedOperation.FileSaveError | 文件存储失败,请稍后重试。 |
FailedOperation.IdFormatError | 输入的身份证号有误。 |
FailedOperation.IdNameMisMatch | 姓名和身份证号不一致,请核实后重试。 |
FailedOperation.IdNoExistSystem | 库中无此号,请到户籍所在地进行核实。 |
FailedOperation.IdPhotoNoExist | 库中无此号照片,请到户籍所在地进行核实。 |
FailedOperation.IdPhotoPoorQuality | 证件图片质量差,请更新后重试。 |
FailedOperation.IdPhotoSystemNoanswer | 客户库自建库或认证中心返照失败,请稍后再试。 |
FailedOperation.IdentityAuthLimitExceeded | 姓名/身份证号认证次数超过当日限制,请次日重试 |
FailedOperation.ImageBlur | 图片模糊。 |
FailedOperation.ImageDecodeFailed | 图片解码失败。 |
FailedOperation.ImageNoIdCard | 图片中未检测到身份证。 |
FailedOperation.ImageSizeTooLarge | 图片尺寸过大。 |
FailedOperation.IncompleteFace | 未检测到完整人脸,请传入完整人脸图片 |
FailedOperation.LifePhotoDetectFaces | 检测到多张人脸。 |
FailedOperation.LifePhotoDetectFake | 实人比对没通过。 |
FailedOperation.LifePhotoDetectNoFaces | 未能检测到完整人脸。 |
FailedOperation.LifePhotoPoorQuality | 传入图片分辨率太低,请重新上传。 |
FailedOperation.LifePhotoSizeError | 传入图片过大或过小。 |
FailedOperation.LipFaceIncomplete | 脸部未完整露出。 |
FailedOperation.LipMoveSmall | 嘴唇动作幅度过小。 |
FailedOperation.LipNetFailed | 视频拉取失败,请重试。 |
FailedOperation.LipSizeError | 视频为空,或大小不合适,请控制录制时长在6s左右。 |
FailedOperation.LipVideoInvalid | 视频格式有误。 |
FailedOperation.LipVideoQuaility | 视频像素太低。 |
FailedOperation.LipVoiceDetect | 未检测到声音。 |
FailedOperation.LipVoiceLow | 视频声音太小。 |
FailedOperation.LipVoiceRecognize | 声音识别失败。 |
FailedOperation.LivessBestFrameError | 人脸检测失败,无法提取比对照。 |
FailedOperation.LivessDetectFail | 活体检测没通过。 |
FailedOperation.LivessDetectFake | 疑似非真人录制。 |
FailedOperation.LivessSystemError | 调用活体引擎接口出错。 |
FailedOperation.LivessUnknownError | 视频实人检测没通过。 |
FailedOperation.NameFormatError | 输入的姓名有误。 |
FailedOperation.OcrFailed | Ocr识别失败。 |
FailedOperation.PoorImageQuality | 图片质量过差,请检查图片质量 |
FailedOperation.RequestLimitExceeded | 调用次数超出限制。 |
FailedOperation.SilentDetectFail | 实人检测失败。 |
FailedOperation.SilentEyeLiveFail | 眼睛检测失败。 |
FailedOperation.SilentFaceDetectFail | 视频未检测到人脸。 |
FailedOperation.SilentFaceQualityFail | 视频中人脸质量低。 |
FailedOperation.SilentFaceWithMaskFail | 检测到带口罩。 |
FailedOperation.SilentMouthLiveFail | 嘴巴检测失败。 |
FailedOperation.SilentMultiFaceFail | 视频检测中有多个人脸。 |
FailedOperation.SilentPictureLiveFail | 疑似翻拍。 |
FailedOperation.SilentThreshold | 实人检测未达到通过标准。 |
FailedOperation.SilentTooShort | 视频录制时间过短,请录制2秒以上的视频。 |
FailedOperation.StsUnAuthErrError | STS未授权。 |
FailedOperation.UnKnown | 内部未知错误。 |
FailedOperation.UnregisteredEid | 该用户未注册E证通,请先注册并跟权威库核验。 |
FailedOperation.VerificationFail | 认证不通过。 |
FailedOperation.VideoDecodeFailed | 视频解码异常 |
InternalError.EncryptSystemError | 加密失败。 |
InternalError.UnKnown | 内部未知错误。 |
InvalidParameter.RuleId | RuleId不存在。 |
InvalidParameter.UnsupportEncryptField | 存在不加密的字段,请参考文档修改。 |
InvalidParameterValue.BizTokenExpired | BizToken过期。 |
InvalidParameterValue.BizTokenIllegal | BizToken不合法。 |
InvalidParameterValue.RuleIdDisabled | 该ruleid已被您停用,请确认后重试。 |
InvalidParameterValue.RuleIdNotExist | RuleId不存在,请到人脸核身控制台申请。 |
UnauthorizedOperation.ActivateError | 服务开通异常。 |
UnauthorizedOperation.Activating | 服务开通中。 |
UnauthorizedOperation.Arrears | 账号已欠费。 |
UnauthorizedOperation.ChargeStatusException | 计费状态异常。 |
UnauthorizedOperation.NonAuthorize | 账号未实名。 |
UnauthorizedOperation.Nonactivated | 未开通服务。 |