功能说明
如果返回结果中存在 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 | 发信模板不存在或者状态不是审核通过状态。 |