错误码
当调用API时,可能遇到下表中的错误码。
 
  - 通过APIG接口管理API,发生错误时,产生的错误码请参考《API网关接口参考》的“错误码”章节。
 - 使用APIG错误码时,请以错误码(如APIG.0101)为准,错误信息并非固定不变,有时会对错误信息进行优化修改。
 
| 
       错误码  | 
     
       错误信息  | 
     
       HTTP状态码  | 
     
       语义  | 
     
       解决方案  | 
    
|---|---|---|---|---|
| 
       APIG.0101  | 
     
       The API does not exist or has not been published in the environment.  | 
     
       404  | 
     
       API不存在或未发布到环境  | 
     
       检查调用API所使用的域名、请求方法、路径和创建的API是否一致;检查API是否发布,如果发布到非生产环境,检查请求X-Stage头是否为发布的环境名;检查调用API使用的域名是否已经绑定到API所在的分组  | 
    
| 
       APIG.0101  | 
     
       The API does not exist.  | 
     
       404  | 
     
       API请求方法不存在  | 
     
       检查API请求方法是否与API定义的方法相同  | 
    
| 
       APIG.0103  | 
     
       The backend does not exist.  | 
     
       500  | 
     
       无法找到后端  | 
     
       联系技术支持  | 
    
| 
       APIG.0104  | 
     
       The plug-ins do not exist.  | 
     
       500  | 
     
       无法找到插件配置  | 
     
       联系技术支持  | 
    
| 
       APIG.0105  | 
     
       The backend configurations do not exist.  | 
     
       500  | 
     
       无法找到后端配置  | 
     
       联系技术支持  | 
    
| 
       APIG.0106  | 
     
       Orchestration error.  | 
     
       400  | 
     
       编排错误  | 
     
       检查API配置的前后端参数是否合理  | 
    
| 
       APIG.0107  | 
     
       The custom lua script encountered an unexpected error  | 
     
       500  | 
     
       Lua脚本发生未知错误  | 
     
       联系技术支持  | 
    
| 
       APIG.0201  | 
     
       API request error.  | 
     
       400  | 
     
       请求格式不合法  | 
     
       使用合法的请求  | 
    
| 
       APIG.0201  | 
     
       Request entity too large.  | 
     
       413  | 
     
       请求body过大(大于12M)  | 
     
       减小请求body大小  | 
    
| 
       APIG.0201  | 
     
       Request URI too large.  | 
     
       414  | 
     
       请求URI过大(大于32K)  | 
     
       减小请求URI大小  | 
    
| 
       APIG.0201  | 
     
       Request headers too large.  | 
     
       494  | 
     
       请求头过大(单个请求头大于32K或所有请求头总长度大于128K)  | 
     
       减小请求头大小  | 
    
| 
       APIG.0201  | 
     
       Backend unavailable.  | 
     
       502  | 
     
       后端不可用  | 
     
       检查API配置的后端地址是否可用  | 
    
| 
       APIG.0201  | 
     
       Backend timeout.  | 
     
       504  | 
     
       后端超时  | 
     
       增大超时时间或缩小后端的处理时间  | 
    
| 
       APIG.0201  | 
     
       An unexpected error occurred  | 
     
       500  | 
     
       内部错误  | 
     
       联系技术支持  | 
    
| 
       APIG.0202  | 
     
       Backend unavailable  | 
     
       502  | 
     
       后端不可用  | 
     
       检查API配置的后端请求协议是否与后端服务请求协议一致  | 
    
| 
       APIG.0203  | 
     
       Backend timeout  | 
     
       504  | 
     
       后端超时  | 
     
       增大超时时间或缩小后端的处理时间  | 
    
| 
       APIG.0204  | 
     
       SSL protocol is not supported: TLSv1.1  | 
     
       400  | 
     
       SSL协议版本不支持  | 
     
       使用支持的SSL协议版本  | 
    
| 
       APIG.0205  | 
     
       Verify client certificate failed  | 
     
       400  | 
     
       客户端证书校验失败  | 
     
       检查客户端证书是否正确  | 
    
| 
       APIG.0301  | 
     
       Incorrect IAM authentication information.  | 
     
       401  | 
     
       IAM认证信息错误  | 
     
       检查token是否正确  | 
    
| 
       APIG.0302  | 
     
       The IAM user is not authorized to access the API.  | 
     
       403  | 
     
       IAM用户不允许访问API  | 
     
       检查用户是否被黑白名单限制  | 
    
| 
       APIG.0303  | 
     
       Incorrect app authentication information.  | 
     
       401  | 
     
       APP认证信息错误  | 
     
       检查请求的方法、路径、查询参数、请求体和签名使用的方法、路径、查询参数、请求体是否一致;检查客户端机器时间是否正确。请参考《开发指南》的“使用APP认证调用API”章节检查签名代码的问题  | 
    
| 
       APIG.0304  | 
     
       The app is not authorized to access the API.  | 
     
       403  | 
     
       APP不允许访问API  | 
     
       检查APP是否授权访问API  | 
    
| 
       APIG.0305  | 
     
       Incorrect authentication information.  | 
     
       401  | 
     
       认证信息错误  | 
     
       检查认证信息是否正确  | 
    
| 
       APIG.0306  | 
     
       API access denied.  | 
     
       403  | 
     
       不允许访问API  | 
     
       检查是否授权访问API  | 
    
| 
       APIG.0307  | 
     
       The token must be updated.  | 
     
       401  | 
     
       token需要更新  | 
     
       重新从IAM获取token  | 
    
| 
       APIG.0308  | 
     
       The throttling threshold has been reached.  | 
     
       429  | 
     
       超出流控值限制  | 
     
       等待流控刷新后访问。如果触发调试域名的单日请求数上限,请绑定独立域名  | 
    
| 
       APIG.0310  | 
     
       The project is unavailable.  | 
     
       403  | 
     
       project不可使用  | 
     
       使用其他project访问  | 
    
| 
       APIG.0311  | 
     
       Incorrect debugging authentication information.  | 
     
       401  | 
     
       调试认证信息错误  | 
     
       联系技术支持  | 
    
| 
       APIG.0312  | 
     
       Incorrect third-party authentication information,auth fail  | 
     
       401  | 
     
       第三方认证信息错误,认证失败  | 
     
       检查身份信息是否正确  | 
    
| 
       APIG.0313  | 
     
       Incorrect third-party authentication information,identities error  | 
     
       401  | 
     
       第三方认证信息错误,身份错误  | 
     
       检查请求中身份信息与第三方认证插件中身份来源设置是否一致  | 
    
| 
       APIG.0314  | 
     
       Incorrect third-party authentication information,access deny  | 
     
       403  | 
     
       第三方认证信息错误,访问拒绝  | 
     
       联系技术支持确认请求来源是否为业务请求,如果是,则提高第三方认证插件的防爆力拦截阈值以解决  | 
    
| 
       APIG.0401  | 
     
       Unknown client IP address.  | 
     
       403  | 
     
       无法识别客户端IP地址  | 
     
       联系技术支持  | 
    
| 
       APIG.0402  | 
     
       The IP address is not authorized to access the API.  | 
     
       403  | 
     
       IP地址不允许访问  | 
     
       检查IP地址是否被黑白名单限制  | 
    
| 
       APIG.0404  | 
     
       Access to the backend IP address has been denied.  | 
     
       403  | 
     
       后端IP不允许访问  | 
     
       后端IP地址或后端域名对应的IP地址不允许访问  | 
    
| 
       APIG.0405  | 
     
       The app is not accessed from a trusted IP address.  | 
     
       403  | 
     
       未从受信任的IP地址访问应用程序  | 
     
       检查源IP是否在访问控制策略中配置了允许或者拒绝  | 
    
| 
       APIG.0501  | 
     
       The app quota has been used up.  | 
     
       405  | 
     
       APP已经超出配额  | 
     
       购买APP配额  | 
    
| 
       APIG.0502  | 
     
       The app has been frozen.  | 
     
       405  | 
     
       APP被冻结  | 
     
       余额不足  | 
    
| 
       APIG.0601  | 
     
       Internal server error.  | 
     
       500  | 
     
       内部错误  | 
     
       联系技术支持  | 
    
| 
       APIG.0602  | 
     
       Bad request.  | 
     
       400  | 
     
       非法请求  | 
     
       检查请求是否合法  | 
    
| 
       APIG.0605  | 
     
       Domain name resolution failed.  | 
     
       500  | 
     
       域名解析失败  | 
     
       检查域名拼写,以及域名是否绑定了正确的后端地址  | 
    
| 
       APIG.0606  | 
     
       Failed to load the API configurations.  | 
     
       500  | 
     
       未加载API配置  | 
     
       联系技术支持  | 
    
| 
       APIG.0607  | 
     
       The following protocol is supported: {xxx}  | 
     
       400  | 
     
       协议不被允许,允许的协议是xxx。 注意:xxx以实际响应中的内容为准。  | 
     
       改用支持的协议(HTTP/HTTPS)访问  | 
    
| 
       APIG.0608  | 
     
       Failed to obtain the admin token.  | 
     
       500  | 
     
       无法获取管理账户  | 
     
       联系技术支持  | 
    
| 
       APIG.0609  | 
     
       The VPC backend does not exist.  | 
     
       500  | 
     
       找不到负载后端  | 
     
       联系技术支持  | 
    
| 
       APIG.0610  | 
     
       No backend available.  | 
     
       502  | 
     
       没有可连接的后端  | 
     
       检查所有后端是否可用,如调用信息与实际配置是否一致  | 
    
| 
       APIG.0611  | 
     
       The backend port does not exist.  | 
     
       500  | 
     
       后端端口未找到  | 
     
       联系技术支持  | 
    
| 
       APIG.0612  | 
     
       An API cannot call itself.  | 
     
       500  | 
     
       API调用自身  | 
     
       修改API后端配置,递归调用层数不能超过10层  | 
    
| 
       APIG.0613  | 
     
       The IAM service is currently unavailable.  | 
     
       503  | 
     
       IAM服务暂时不可用  | 
     
       联系技术支持  | 
    
| 
       APIG.0615  | 
     
       Incorrect third-party authentication VPC information  | 
     
       500  | 
     
       获取第三方鉴权负载通道节点失败  | 
     
       检查第三方认证的负载通道配置是否正确  | 
    
| 
       APIG.0616  | 
     
       Incorrect third-party authentication request information  | 
     
       500  | 
     
       连接第三方鉴权服务失败  | 
     
       检查第三方认证服务是否正常  | 
    
| 
       APIG.0617  | 
     
       Incorrect third-party authentication response information  | 
     
       500  | 
     
       获取第三方鉴权服务响应失败  | 
     
       检查第三方认证服务是否正常  | 
    
| 
       APIG.0705  | 
     
       Backend signature calculation failed.  | 
     
       500  | 
     
       计算后端签名失败  | 
     
       联系技术支持  | 
    
| 
       APIG.0802  | 
     
       The IAM user is forbidden in the currently selected region  | 
     
       403  | 
     
       该IAM用户在当前region中被禁用  | 
     
       联系技术支持  | 
    
| 
       APIG.2102  | 
     
       PublicKey is null  | 
     
       400  | 
     
       签名密钥未找到  | 
     
       联系技术支持  | 
    
| 
       APIG.2201  | 
     
       Appkey or SecretKey is invalid  | 
     
       400  | 
     
       Appkey或SecretKey不合法  | 
     
       检查请求的Appkey或SecretKey是否正确  | 
    
| 
       APIG.2202  | 
     
       Refresh token is invalid  | 
     
       400  | 
     
       Refresh token不合法  | 
     
       检查Refresh token是否正确  | 
    
| 
       APIG.2203  | 
     
       Access token is invalid  | 
     
       400  | 
     
       Access token不合法  | 
     
       检查Access token是否正确  | 
    
| 
       APIG.2204  | 
     
       ContentType invalid  | 
     
       400  | 
     
       ContentType不合法  | 
     
       检查ContentType是否正确  | 
    
| 
       APIG.2205  | 
     
       Auth parameter invalid  | 
     
       400  | 
     
       认证参数不合法  | 
     
       检查认证参数是否正确  | 
    
| 
       APIG.2206  | 
     
       Auth method invalid  | 
     
       400  | 
     
       认证方法不合法  | 
     
       检查认证方法是否正确  | 
    
| 
       APIG.2208  | 
     
       The length of through_data is out of range  | 
     
       400  | 
     
       through_data超长  | 
     
       through_data长度上限为300,根据实际情况调整through_data内容  | 
    
| 
       APIG.2209  | 
     
       The value of grant_type is not in enum List  | 
     
       400  | 
     
       grant_type的值不合法  | 
     
       grant_type只支持client_credentials、refresh_token,根据实际情况修改  | 
    
| 
       APIG.2210  | 
     
       Lack of grant_type  | 
     
       400  | 
     
       缺少授权类型  | 
     
       添加grant_type  | 
    
| 
       APIG.2211  | 
     
       Lack of client_id  | 
     
       400  | 
     
       缺少客户端ID  | 
     
       添加客户端ID  | 
    
| 
       APIG.2212  | 
     
       Lack of client_secret  | 
     
       400  | 
     
       缺少客户端密钥  | 
     
       添加客户端密钥  | 
    
| 
       APIG.2213  | 
     
       Lack of refresh_token  | 
     
       400  | 
     
       缺少refresh token  | 
     
       联系技术支持  | 
    
| 
       APIG.1001  | 
     
       Refresh token is expired  | 
     
       401  | 
     
       Refresh token过期  | 
     
       重新获取refresh token  | 
    
| 
       APIG.1002  | 
     
       Access token is expired  | 
     
       401  | 
     
       Access token过期  | 
     
       重新获取access token  | 
    
| 
       APIG.1003  | 
     
       App not match refresh token  | 
     
       401  | 
     
       App与refresh token不匹配  | 
     
       检查client_id是否正确  | 
    
| 
       APIG.1004  | 
     
       App not exist  | 
     
       401  | 
     
       App不存在  | 
     
       检查access token是否正确  | 
    
| 
       APIG.1009  | 
     
       AppKey or AppSecret is invalid  | 
     
       400  | 
     
       AppKey或AppSecret不合法  | 
     
       检查请求的AppKey或AppSecret是否正确  |