在调用API网关开放的API服务时,如天气查询、IP查询、图像识别等API服务,我们可能会遇到以下错误代码,以下为API调用错误代码表,读懂错误代码方便我们进行排查解决问题。
API调用服务器错误代码HttpCode是5xx
服务端错误码表,HttpCode是5xx,表示服务不可用。此时一般建议重试或联系商品页面的API服务商。
Http 状态码
Internal Error
API 网关内部错误
建议重试。
Failed To Invoke Backend Service
底层服务错误
API 提供者底层服务错误,建议重试,如果重试多次仍然不可用,可联系 API 服务商解决。
Service Unavailable
服务不可用
建议稍后重试。
Async Service
后端服务超时
建议稍后重试。
API调用客户端错误代码HttpCode为4xx
客户端错误码表,HttpCode为4xx,表示业务报错。此时一般为参数错误、签名错误、请求方式有误或被流控限制等业务类错误。建议详细查看错误码,针对性解决问题。
Http 状态码
Throttled by USER Flow Control
因用户流控被限制
一般是由于 API 服务商设置的用户流控值导致被流控,可以联系 API 服务商协商放宽限制。
Throttled by APP Flow Control
因APP流控被限制
一般是由于 API 服务商设置的 APP 流控值导致被流控,可以联系 API 服务商协商放宽限制。
Throttled by API Flow Control
因 API 流控被限制
一般是由于 API 服务商设置的 API 流控值导致被流控,可以联系 API 服务商协商放宽限制。
Throttled by DOMAIN Flow Control
因二级域名流控被限制
直接访问二级域名调用 API,每天被访问次数上限1000次。
TThrottled by GROUP Flow Control
因分组流控被限制
每个分组有 QPS 限制,可以联系 API 服务商反馈。
Quota Exhausted
调用次数已用完
购买的次数已用完。
Quota Expired
购买次数已过期
购买的次数已经过期。
User Arrears
用户已欠费
请尽快充值续费。
Empty Request Body
body 为空
请检查请求 Body 内容。
Invalid Request Body
body 无效
请检查请求 Body。
Invalid Param Location
参数位置错误
请求参数位置错误。
Unsupported Multipart
不支持上传
不支持上传文件。
Invalid Url
Url 无效
请求的 Method、Path 或者环境不对。请参照错误说明
Invalid Url
。
Invalid Domain
请求域名无效,根据域名找不到 API。请联系 API 服务商。
Invalid HttpMethod
HttpMethod 无效
输入的 Method 不合法。
Invalid AppKey
AppKey 无效或不存在
请检查传入的 AppKey。注意左右空格的影响。
Invalid AppSecret
APP 的Secret 错误
检查传入的 AppSecret。注意左右空格的影响。
Timestamp Expired
时间戳过时
请核对请求系统时间是否为标准时间。
Invalid Timestamp
时间戳不合法
请参照
请求签名说明文档
。
Empty Signature
请传入签名字符串,请参照
请求签名说明文档
。
Invalid Signature, Server StringToSign:%s
签名无效,参照
Invalid Signature
错误说明
Invalid Content-MD5
Content-MD5 值不合法
请求 Body 为空,但传入了 MD5 值,或 MD5 值计算错误。请参照
请求签名说明文档
。
Unauthorized
APP 未获得要调用的 API 的授权。请参照错误说明
Unauthorized
。
Nonce Used
SignatureNonce 已被使用一次
SignatureNonce 不能被重复使用。
API Not Found
找不到 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.
服务不可用
建议重试。
InternalError
The request processing has failed due to some unknown error, exception or failure.
建议重试。
调用API网关开放的管控OpenAPI时HttpCode为4xx
客户端错误码,HttpCode为4xx,表示业务错误。一般为参数错误、权限限制、业务逻辑错误等问题,此时需要仔细查看错误码,并针对性解决问题。
Http 状态码
Repeated%s
The specified %s is repeated.
某参数重复(%s 是占位符,实际调用会给出明确的参数名或提示。)
建议按照提示修改重复的参数后重试。
RepeatedCommit
Resubmit request.
请不要频繁提交请求。
Missing%s
The %s is mandatory for this action.
缺少参数 %s
根据具体返回补充缺少的参数,重试请求。
MissingAppIdOrAppOwner
AppId or AppOwner must have a valid value.
缺少参数 AppId 或者 AppOwner
参数 AppId 和 AppOwner 不能同时为空。
Invalid%s
The specified parameter %s value is not valid.
根据返回提示的具体参数,查看相关参数约束,修改后重试。
NotFound%s
Cannot find resource according to your specified %s.
找不到资源
根据指定的参数%s找不到资源,建议检查%s是否正确。
InvalidFormat%s
The specified parameter %s value is not well formatted.
参数格式错误
建议根据实际返回提示,查看%s的格式要求,修改后重试。
Duplicate%s
The specified parameter %s value is duplicate.
某请求参数不允许重复,建议检查修正后重试。
DependencyViolation%s
The specified %s has %s definitions.
参数依赖错误
指定参数被依赖,不能随意删除,请先解除依赖。
Forbidden%s
Not allowed to operate on the specified %s.
无权操作/操作禁止
您无权执行该操作。
NoPermission
User is not authorized to operate on the specified resource.
RAM 鉴权不通过。
ExceedLimit%s
The specified %s count exceeds the limit.
超出个数限制
一般指用户账户下创建的 API、API 分组或者APP超出个数限制。
UserNotFound
The specified user can not be found.
指定用户找不到
根据输入的用户信息找不到该用户。
DomainCertificateNotFound
Cannot find the domain certificate.
指定域名证书不存在
建议检查传入的证书 ID 及名称。
DomainNotResolved
The specified domain has not been resolved.
指定域名未解析
需要将指定域名 CNAME 解析到分组的二级域名上,才能完成绑定。域名解析是在用户域名购买的网站上操作。
InvalidICPLicense
The specified domain have not got ICP license, or the ICP license does not belong to Aliyun.
域名备案不合格
要绑定的域名需要在阿里云做首次备案,已经在其他系统做备案的,需要在阿里云备案接入。备案接入需要获取备案号,在阿里云有 ECS 且具有公网 IP 的,每个 ECS 有5个备案号。
Invalid%s.LengthLimit
The parameter %s length exceeds the limit.
参数%s超出长度限制,建议修正后重试。
InvalidApiDefault
The ApiDefault value exceeds limit.
流控 API 默认值超过限制值
该值数值不能超过1亿,与单位无关。如需上调请提工单申请。
InvalidAppDefault
The AppDefault value must smaller than the UserDefault and ApiDefault.
AppDefault 的值不符合规则
该值需要小于 API 流控值和用户流控值。
InvalidUserDefault
The UserDefault value must bigger than the AppDefault and smaller than the ApiDefault.
UserDefault 的值不符合规则
该值需要小于 API 流控值并大于 APP 流控值。
InvalidParamMapping
Parameters must be fully mapped.
参数映射无效
创建 API 时,前后端参数映射需要是全映射。即每个入参都需要配置后端参数名称。
InvalidOwnerAccount
OwnerAccount is invalid.
APP所有者账号无效
一般为操作授权时,输入目标用户的阿里云邮箱账号,该账号无效。建议检查修正后重试。
ServiceForbidden
Your Gateway service is forbidden by risk control.
API 网关服务被风控(应该使用户被风控吧)
请注意不要频繁请求,建议稍后重试。若重试后仍未解决,可提工单咨询。
ServiceUnOpen
Your Gateway service has not been opened.
服务未开通
建议到阿里云官网开通一下 API 网关服务。
ServiceInDept
Your API Gateway service is in dept.
(您的 API 网关)服务欠费
充值或者结算后重新开始使用。
EqualSignature
The new signature is the same as the old.
新密钥与旧的相等
修改后端签名密钥时,新设置的 Key 和 Secret 不能跟原来的一样。
CertificateNotMatch
The domain does not match the one in the certificate.
证书不匹配
指定域名与证书内域名不匹配。
CertificateKeyNotMatch
The certificate private key does not match the public key.
证书密钥不匹配
证书的公钥和私钥不匹配。
PrivateKeyEncrypted
The certificate private key is encrypted, please upload the unencrypted version.
密钥不能加密
证书私钥加密了,要求上传不加密的版本。
CertificateSecretKeyError
The certificate private key is invalid.
证书私钥错误
建议检查后重新传入。
InvalidApiServiceAddress
The specified service address is not valid.
API 后端服务地址无效
配置的 API 后端服务地址无效。
客户端公用错误码,HttpCode为4xx,调用全阿里云产品的OpenAPI均可能遇到,表示业务错误。一般为请求格式错误、请求方式错误、必填参数丢失、参数格式错误、签名错误、流控限制等问题。此时需查看具体错误码,针对性解决问题。
API 找不到。
InvalidApi.NotFound
Specified api is not found,
please check your url and method.
请检查指定的 action 接口名称是否正确,注意大小写区分。
缺少必填参数。
Missing{ParameterName}
{ParameterName} is mandatory for this action.
指定参数为必填参数,请传入。
AccessKeyId 找不到
InvalidAccessKeyId.NotFound
Specified access key is not found.
请检查调用时是否传入正确的 AccessKeyId。
AccessKeyId 被禁用。
InvalidAccessKeyId.Inactive
Specified access key is disabled.
检查 AK 是否可用。
时间戳格式不对( Date 和 Timestamp)。
InvalidTimeStamp.Format
Specified time stamp or date value is not well formatted.
检查时间戳。
用户时间和服务器时间超过15分钟。
InvalidTimeStamp.Expired
Specified time stamp or date value is expired.
检查时间戳。
SignatureNonce 重复
SignatureNonceUsed
Specified signature nonce war used already.
返回值格式不正确。
InvalidParameter.Format
Specified parameter format is not valid.
仅支持 XML/JSON。
参数值校验不通过。
Invalid{ParameterName}
Specified parameter {ParameterName} is not valid.
请检查指定参数的值。
Http 请求方法不支持。
UnsupportedHTTPMethod
Specified signature is not matched with our calculation.
请检查请求Method。
签名方法不支持。
InvalidSignatureMethod
Specified signature method is not valid.
默认可以不填写该值。
签名不通过。
SignatureDoesNotMatch
Specified signature is not matched with our calculation.
签名不通过。
用户调用频率超限。
Throttling.User
Request was denied due to user flow control.
请稍后访问,降低访问频率。
API 访问频率超限。
Throttling.API
Request was denied due to api flow control.
请稍后访问,降低访问频率。
缺少AccessKeyId。
MissingSecurityToken
SecurityToken is mandatory for this action.
请检查是否传入有效AccessKeyId。
16核32G28M服务器3468元/15个月
注意:以上特价轻量服务器限制条件为“产品首单特惠”,如果你的腾讯云账号已经是老用户,建议重新
注册一个腾讯云账号
,如果你是新用户符合条件,那么无脑入,这个CPU内存带宽配置,价格确实便宜,值得买!
2023云厂商云服务器优惠活动汇总:
①阿里云:
2023阿里云服务器69元一年起(1核2G/2核4G/4核8G...)
②腾讯云:
腾讯云2核4G8M带宽服务器70元起
(多配置可选 价格很低)
③华为云:
华为云服务器60元一年起(查看更多配置报价)