错误码

最近更新时间:2024-07-19 01:47:34

我的收藏

功能说明

如果返回结果中存在 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 未开通服务。