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