API调用错误代码表

在调用API网关开放的API服务时，如天气查询、IP查询、图像识别等API服务，我们可能会遇到以下错误代码，以下为API调用错误代码表，读懂错误代码方便我们进行排查解决问题。

API调用服务器错误代码HttpCode是5xx

服务端错误码表，HttpCode是5xx，表示服务不可用。此时一般建议重试或联系商品页面的API服务商。

错误代码	Http 状态码	语义	解决方案
Internal Error	500	API 网关内部错误	建议重试。
Failed To Invoke Backend Service	500	底层服务错误	API 提供者底层服务错误，建议重试，如果重试多次仍然不可用，可联系 API 服务商解决。
Service Unavailable	503	服务不可用	建议稍后重试。
Async Service	504	后端服务超时	建议稍后重试。

API调用客户端错误代码HttpCode为4xx

客户端错误码表，HttpCode为4xx，表示业务报错。此时一般为参数错误、签名错误、请求方式有误或被流控限制等业务类错误。建议详细查看错误码，针对性解决问题。

错误代码	Http 状态码	语义	解决方案
Throttled by USER Flow Control	403	因用户流控被限制	一般是由于 API 服务商设置的用户流控值导致被流控，可以联系 API 服务商协商放宽限制。
Throttled by APP Flow Control	403	因APP流控被限制	一般是由于 API 服务商设置的 APP 流控值导致被流控，可以联系 API 服务商协商放宽限制。
Throttled by API Flow Control	403	因 API 流控被限制	一般是由于 API 服务商设置的 API 流控值导致被流控，可以联系 API 服务商协商放宽限制。
Throttled by DOMAIN Flow Control	403	因二级域名流控被限制	直接访问二级域名调用 API，每天被访问次数上限1000次。
TThrottled by GROUP Flow Control	403	因分组流控被限制	每个分组有 QPS 限制，可以联系 API 服务商反馈。
Quota Exhausted	403	调用次数已用完	购买的次数已用完。
Quota Expired	403	购买次数已过期	购买的次数已经过期。
User Arrears	403	用户已欠费	请尽快充值续费。
Empty Request Body	400	body 为空	请检查请求 Body 内容。
Invalid Request Body	400	body 无效	请检查请求 Body。
Invalid Param Location	400	参数位置错误	请求参数位置错误。
Unsupported Multipart	400	不支持上传	不支持上传文件。
Invalid Url	400	Url 无效	请求的 Method、Path 或者环境不对。请参照错误说明 Invalid Url。
Invalid Domain	400	域名无效	请求域名无效，根据域名找不到 API。请联系 API 服务商。
Invalid HttpMethod	400	HttpMethod 无效	输入的 Method 不合法。
Invalid AppKey	400	AppKey 无效或不存在	请检查传入的 AppKey。注意左右空格的影响。
Invalid AppSecret	400	APP 的Secret 错误	检查传入的 AppSecret。注意左右空格的影响。
Timestamp Expired	400	时间戳过时	请核对请求系统时间是否为标准时间。
Invalid Timestamp	400	时间戳不合法	请参照 请求签名说明文档。
Empty Signature	404	签名为空	请传入签名字符串，请参照 请求签名说明文档。
Invalid Signature, Server StringToSign:%s	400	签名无效	签名无效，参照 Invalid Signature 错误说明
Invalid Content-MD5	400	Content-MD5 值不合法	请求 Body 为空，但传入了 MD5 值，或 MD5 值计算错误。请参照 请求签名说明文档。
Unauthorized	403	未被授权	APP 未获得要调用的 API 的授权。请参照错误说明 Unauthorized。
Nonce Used	400	SignatureNonce 已被使用一次	SignatureNonce 不能被重复使用。
API Not Found	400	找不到 API	传入的 GroupId、Stage 等参数不正确，或已下线。

当您调用API网关开放的管控OpenAPI时，如CreateAPI、ModifyAPI、DeleteAPI等，您可能遇到以下错误码。

调用API网关开放的管控OpenAPI时HttpCode为5xx

服务端错误码，HttpCode为5xx，表示服务不可用。此时建议重试。

错误代码	描述	Http 状态码	语义	解决方案
ServiceUnavailable	The request has failed due to a temporary failure of the server.	503	服务不可用	建议重试。
InternalError	The request processing has failed due to some unknown error, exception or failure.	500	内部错误	建议重试。

调用API网关开放的管控OpenAPI时HttpCode为4xx

客户端错误码，HttpCode为4xx，表示业务错误。一般为参数错误、权限限制、业务逻辑错误等问题，此时需要仔细查看错误码，并针对性解决问题。

错误代码	描述	Http 状态码	语义	解决方案
Repeated%s	The specified %s is repeated.	400	某参数重复（%s 是占位符，实际调用会给出明确的参数名或提示。）	建议按照提示修改重复的参数后重试。
RepeatedCommit	Resubmit request.	400	请求重复	请不要频繁提交请求。
Missing%s	The %s is mandatory for this action.	400	缺少参数 %s	根据具体返回补充缺少的参数，重试请求。
MissingAppIdOrAppOwner	AppId or AppOwner must have a valid value.	400	缺少参数 AppId 或者 AppOwner	参数 AppId 和 AppOwner 不能同时为空。
Invalid%s	The specified parameter %s value is not valid.	400	参数无效	根据返回提示的具体参数，查看相关参数约束，修改后重试。
NotFound%s	Cannot find resource according to your specified %s.	400	找不到资源	根据指定的参数%s找不到资源，建议检查%s是否正确。
InvalidFormat%s	The specified parameter %s value is not well formatted.	400	参数格式错误	建议根据实际返回提示，查看%s的格式要求，修改后重试。
Duplicate%s	The specified parameter %s value is duplicate.	400	参数重复	某请求参数不允许重复，建议检查修正后重试。
DependencyViolation%s	The specified %s has %s definitions.	400	参数依赖错误	指定参数被依赖，不能随意删除，请先解除依赖。
Forbidden%s	Not allowed to operate on the specified %s.	403	无权操作/操作禁止	您无权执行该操作。
NoPermission	User is not authorized to operate on the specified resource.	403	无权操作	RAM 鉴权不通过。
ExceedLimit%s	The specified %s count exceeds the limit.	400	超出个数限制	一般指用户账户下创建的 API、API 分组或者APP超出个数限制。
UserNotFound	The specified user can not be found.	404	指定用户找不到	根据输入的用户信息找不到该用户。
DomainCertificateNotFound	Cannot find the domain certificate.	400	指定域名证书不存在	建议检查传入的证书 ID 及名称。
DomainNotResolved	The specified domain has not been resolved.	400	指定域名未解析	需要将指定域名 CNAME 解析到分组的二级域名上，才能完成绑定。域名解析是在用户域名购买的网站上操作。
InvalidICPLicense	The specified domain have not got ICP license, or the ICP license does not belong to Aliyun.	400	域名备案不合格	要绑定的域名需要在阿里云做首次备案，已经在其他系统做备案的，需要在阿里云备案接入。备案接入需要获取备案号，在阿里云有 ECS 且具有公网 IP 的，每个 ECS 有5个备案号。
Invalid%s.LengthLimit	The parameter %s length exceeds the limit.	400	长度超限	参数%s超出长度限制，建议修正后重试。
InvalidApiDefault	The ApiDefault value exceeds limit.	400	流控 API 默认值超过限制值	该值数值不能超过1亿，与单位无关。如需上调请提工单申请。
InvalidAppDefault	The AppDefault value must smaller than the UserDefault and ApiDefault.	400	AppDefault 的值不符合规则	该值需要小于 API 流控值和用户流控值。
InvalidUserDefault	The UserDefault value must bigger than the AppDefault and smaller than the ApiDefault.	400	UserDefault 的值不符合规则	该值需要小于 API 流控值并大于 APP 流控值。
InvalidParamMapping	Parameters must be fully mapped.	400	参数映射无效	创建 API 时，前后端参数映射需要是全映射。即每个入参都需要配置后端参数名称。
InvalidOwnerAccount	OwnerAccount is invalid.	400	APP所有者账号无效	一般为操作授权时，输入目标用户的阿里云邮箱账号，该账号无效。建议检查修正后重试。
ServiceForbidden	Your Gateway service is forbidden by risk control.	400	API 网关服务被风控（应该使用户被风控吧）	请注意不要频繁请求，建议稍后重试。若重试后仍未解决，可提工单咨询。
ServiceUnOpen	Your Gateway service has not been opened.	400	服务未开通	建议到阿里云官网开通一下 API 网关服务。
ServiceInDept	Your API Gateway service is in dept.	400	（您的 API 网关）服务欠费	充值或者结算后重新开始使用。
EqualSignature	The new signature is the same as the old.	400	新密钥与旧的相等	修改后端签名密钥时，新设置的 Key 和 Secret 不能跟原来的一样。
CertificateNotMatch	The domain does not match the one in the certificate.	400	证书不匹配	指定域名与证书内域名不匹配。
CertificateKeyNotMatch	The certificate private key does not match the public key.	400	证书密钥不匹配	证书的公钥和私钥不匹配。
PrivateKeyEncrypted	The certificate private key is encrypted, please upload the unencrypted version.	400	密钥不能加密	证书私钥加密了，要求上传不加密的版本。
CertificateSecretKeyError	The certificate private key is invalid.	400	证书私钥错误	建议检查后重新传入。
InvalidApiServiceAddress	The specified service address is not valid.	400	API 后端服务地址无效	配置的 API 后端服务地址无效。

客户端公用错误码，HttpCode为4xx，调用全阿里云产品的OpenAPI均可能遇到，表示业务错误。一般为请求格式错误、请求方式错误、必填参数丢失、参数格式错误、签名错误、流控限制等问题。此时需查看具体错误码，针对性解决问题。

报错场景	错误码	错误提示	状态码	建议
API 找不到。	InvalidApi.NotFound	Specified api is not found, please check your url and method.	404	请检查指定的 action 接口名称是否正确，注意大小写区分。
缺少必填参数。	Missing{ParameterName}	{ParameterName} is mandatory for this action.	400	指定参数为必填参数，请传入。
AccessKeyId 找不到	InvalidAccessKeyId.NotFound	Specified access key is not found.	404	请检查调用时是否传入正确的 AccessKeyId。
AccessKeyId 被禁用。	InvalidAccessKeyId.Inactive	Specified access key is disabled.	400	检查 AK 是否可用。
时间戳格式不对( Date 和 Timestamp)。	InvalidTimeStamp.Format	Specified time stamp or date value is not well formatted.	400	检查时间戳。
用户时间和服务器时间超过15分钟。	InvalidTimeStamp.Expired	Specified time stamp or date value is expired.	400	检查时间戳。
SignatureNonce 重复	SignatureNonceUsed	Specified signature nonce war used already.	400
返回值格式不正确。	InvalidParameter.Format	Specified parameter format is not valid.	400	仅支持 XML/JSON。
参数值校验不通过。	Invalid{ParameterName}	Specified parameter {ParameterName} is not valid.	400	请检查指定参数的值。
Http 请求方法不支持。	UnsupportedHTTPMethod	Specified signature is not matched with our calculation.	400	请检查请求Method。
签名方法不支持。	InvalidSignatureMethod	Specified signature method is not valid.	400	默认可以不填写该值。
签名不通过。	SignatureDoesNotMatch	Specified signature is not matched with our calculation.	400	签名不通过。
用户调用频率超限。	Throttling.User	Request was denied due to user flow control.	400	请稍后访问，降低访问频率。
API 访问频率超限。	Throttling.API	Request was denied due to api flow control.	400	请稍后访问，降低访问频率。
缺少AccessKeyId。	MissingSecurityToken	SecurityToken is mandatory for this action.	400	请检查是否传入有效AccessKeyId。

2023腾讯云服务器超便宜，这个价格太可以了，抓紧上车！

• 2核2G3M服务器30元/3个月：点此直达
• 2核2G3M服务器95元一年：点此直达
• 2核2G4M服务器112元/1年：点此直达
• 2核2G4M服务器396元/1年：点此直达
• 2核4G5M服务器168元/3年：点此直达
• 2核4G5M服务器628元/3年：点此直达
• 4核8G12M服务器446元/1年 518元15个月：点此直达
• 8核16G18M服务器1668元/15个月
• 16核32G28M服务器3468元/15个月

注意：以上特价轻量服务器限制条件为“产品首单特惠”，如果你的腾讯云账号已经是老用户，建议重新注册一个腾讯云账号，如果你是新用户符合条件，那么无脑入，这个CPU内存带宽配置，价格确实便宜，值得买！