错误码

最近更新时间:2024-01-05 01:23:17

我的收藏

功能说明

如果返回结果中存在 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.AttachContentToolarge 附件太大,请参考单个附件以及附件总量大小限制。
FailedOperation.EmailAddrInBlacklist 邮件地址在黑名单中。
FailedOperation.EmailContentToolarge 邮件内容太大,请减少发送邮件内容。
FailedOperation.ExceedSendLimit 超出当日总量发送限制。
FailedOperation.ExceedTemplateLimit 超出最大模板数量限制。
FailedOperation.FrequencyLimit 触发频率控制,短时间内对同一地址发送过多邮件。
FailedOperation.HighRejectionRate 拒信率过高,被临时block。
FailedOperation.IllegalURL 邮件包含不合规链接
FailedOperation.IncorrectEmail 邮箱地址错误。
FailedOperation.IncorrectSender 发件人格式不正确。请参考文档示例填写。
FailedOperation.InsufficientBalance 余额不足,账号欠费等。
FailedOperation.InsufficientQuota 套餐包额度不足。
FailedOperation.InvalidAttachName 不支持的附件名称,请检查附件名称是否含有特殊字符,详情请参考附录附件说明
FailedOperation.InvalidLimit 超过查询限制,Limit最大支持100。
FailedOperation.InvalidTemplateID 模板ID无效或者不可用。
FailedOperation.MissingEmailContent 缺少发信内容(TemplateData和Simple不能同时为空)。
FailedOperation.NoAttachPermission 没有附件发送权限,请检查。
FailedOperation.NotAuthenticatedSender 发件sender没有经过认证,无法发送。
FailedOperation.NotSupportDate 不支持查询该日期邮件记录,仅支持查询90天之内的数据。
FailedOperation.ProtocolCheckErr 协议检查错误,请检查协议是否正确。
FailedOperation.ReceiverHasUnsubscribed 收件人已退订。
FailedOperation.RejectedByRecipients 邮件被收信人拒绝。
FailedOperation.SendEmailErr 您的发送遇到问题,请联系腾讯云提交工单沟通原因并解决。
FailedOperation.ServiceNotAvailable 临时性错误,请求未生效,请重试。
FailedOperation.TemplateContentToolarge 模板内容太大,请减少模板内容。
FailedOperation.TemporaryBlocked 因触发了对应的收件服务商限制,邮件推送平台会对该服务商发信暂停10分钟,10分钟后自动解除。
FailedOperation.TooManyAttachments 附件数量太多,单封邮件最多支持10个附件。
FailedOperation.TooManyRecipients 收件人数太多,最多支持同时发送50人。
FailedOperation.URLForbidden 禁止到达率低用户在邮件内容中带有URL 网页链接
FailedOperation.UnsupportMailType 不支持的邮箱类型。
FailedOperation.WithOutPermission 仅支持使用模板发送邮件。
FailedOperation.WrongContentJson TemplateData字段格式不正确,请保持为json格式。
InvalidParameterValue.AttachContentIsWrong 附件内容错误,请检查base64内容是否正确。
InvalidParameterValue.BeginTimeBeforeNow 开始时间不能早于当前时间。
InvalidParameterValue.CreatedByOther 该域名已被其他腾讯云账号创建。
InvalidParameterValue.EmailAddressIsNULL 收件或者发件地址为空,请检查邮件地址。
InvalidParameterValue.EmailContentIsWrong 邮件内容错误,请检查TEXT/HTML base64是否正确。
InvalidParameterValue.IllegalEmailAddress 邮件地址不合法,请检查邮件地址格式。
InvalidParameterValue.IllegalSenderName 发信人别名错误。
InvalidParameterValue.InValidTemplateData 收件人地址附带的模板参数不能包含html标签。
InvalidParameterValue.InvalidEmailIdentity 域名取值错误。
InvalidParameterValue.InvalidSmtpPassWord 密码长度为10~20位,且必须至少包含2位不重复的数字、小写字母、大写字母。
InvalidParameterValue.NoSuchSender 您没有这个发件地址,请检查是否存在。
InvalidParameterValue.NotExistDomain 该域名还没有创建,请先新建发信域名。
InvalidParameterValue.ReceiverDescIllegal 收件人列表描述不合法,描述不可包含特殊字符,字符长度范围:1~300。
InvalidParameterValue.ReceiverEmailInvalid 收件人地址错误。
InvalidParameterValue.ReceiverNameIllegal 收件人列表名字不合法,请检查字符内容及大小。
InvalidParameterValue.RepeatCreation 该域名已经创建过了,请勿重复创建。
InvalidParameterValue.RepeatEmailAddress 该邮件地址已经创建过了,请勿重复创建。
InvalidParameterValue.RepeatReceiverName 收件人列表名称重复。
InvalidParameterValue.SubjectLengthError 邮件主题长度必须为1-100。
InvalidParameterValue.TemplateContentIsNULL 模板资源为空。
InvalidParameterValue.TemplateContentIsWrong 模板内容错误,请检查base64内容是否正确。
InvalidParameterValue.TemplateDataError 模板参数必须为json格式。
InvalidParameterValue.TemplateDataInconsistent 模板参数变量名与之前不一致。
InvalidParameterValue.TemplateDataLenLimit 单条收件人地址附带的模板参数(整个 JSON 结构), 长度超过限制 800 bytes
InvalidParameterValue.TemplateNameIllegal 模板名字不合法,请检查字符内容及大小。
InvalidParameterValue.TemplateNameIsNULL 模板名字不能为空。
InvalidParameterValue.TemplateNotExist 不存在该模板,请先创建模板。
InvalidParameterValue.TemplateNotMatchData 模板变量与收件人列表参数不一一对应。
InvalidParameterValue.WrongDate 搜索日期错误,请检查日期及格式是否有效。
LimitExceeded.ExceedReceiverLimit 收件人列表数量超过限制。
LimitExceeded.ReceiverDetailCountLimit 该收件人列表包含的收件人地址总量超过限制。
LimitExceeded.ReceiverDetailRequestLimit 请求的收件人地址数量超过限制。
MissingParameter.CycleParamNecessary 周期发送任务需选择开始时间和间隔时间。
MissingParameter.EmailsNecessary 收件人地址必须传。
MissingParameter.ReceiverIdNecessary 收件人列表Id必传。
MissingParameter.SendParamNecessary 发件地址、收件人列表,发件模板必须传。
MissingParameter.TimedParamNecessary 定时发送任务需选择开始时间。
OperationDenied 操作被拒绝。
OperationDenied.DomainNotVerified 域名验证失败,请检查域名是否通过验证。
OperationDenied.ExceedDomainLimit 超出最大发信域名限制。
OperationDenied.ExceedSenderLimit 超出最大发信地址限制。
OperationDenied.ReceiverIsOperating 收件人列表正在上传中,请稍后操作。
OperationDenied.ReceiverNotExist 收件人列表不存在。
OperationDenied.ReceiverStatusError 收件人列表空或状态不是上传完成。
OperationDenied.RepeatPassWord 不能与上一次设置密码相同。
OperationDenied.SendAddressStatusError 发信地址不存在或者状态不是通过状态。
OperationDenied.TemplateStatusError 发信模板不存在或者状态不是审核通过状态。