附录：API错误码

更新时间：2023-03-01 GMT+08:00

用户调用API失败时，系统返回的错误码如下所示。

表1 错误码
HTTP状态码	错误码	错误描述	解决方案
404	APIC.0101	The API does not exist or has not been published in the environment.	检查域名、方法、路径和注册的API是否一致。检查API是否发布，如果发布到非生产环境，检查请求X-Stage头是否为发布的环境名。
500	APIC.0103	The backend does not exist.	联系技术支持。
500	APIC.0104	The plug-ins do not exist.	联系技术支持。
500	APIC.0105	The backend configurations do not exist.	联系技术支持。
400	APIC.0106	Orchestration error.	检查API配置的前后端参数是否合理。
400	APIC.0201	Bad request.	使用合法的请求。
413	APIC.0201	Request entity too large.	减小请求body大小，小于12M。
414	APIC.0201	Request URI too large.	减小请求URI大小，小于32K。
494	APIC.0201	Request headers too large.	减小请求头大小，单个请求头小于32K或所有请求头总长度小于128K。
502	APIC.0202	Backend unavailable.	检查API配置的后端地址是否可用。
504	APIC.0203	Backend timeout.	增大超时时间或缩小后端的处理时间。
401	APIC.0301	Incorrect IAM authentication information.	检查token是否正确。
403	APIC.0302	The IAM user is not authorized to access the API.	检查用户是否被黑白名单限制。
401	APIC.0303	Incorrect App authentication information.	检查请求的方法、路径、查询参数、请求体和签名使用的方法、路径、查询参数、请求体是否一致。检查客户端机器时间是否正确。
403	APIC.0304	The app is not authorized to access the API.	检查APP是否授权访问API。
401	APIC.0305	Incorrect authentication information.	检查认证信息是否正确。
403	APIC.0306	API access denied.	检查是否授权访问API。
401	APIC.0307	The token must be updated.	token需要更新。
429	APIC.0308	The throttling threshold has been reached.	等待流控时间结束后再访问API，或修改流控限制值。
403	APIC.0401	Unknown client IP address.	联系技术支持。
403	APIC.0402	The IP address is not authorized to access the API.	检查IP地址是否被黑白名单限制。
503	APIC.0404	Access to the backend IP address has been denied.	使用可用的IP地址访问后端服务。
403	APIC.0405	The app is not accessed from a trusted IP address.	检查IP地址是否被客户端访问控制策略限制。
500	APIC.0601	Internal server error.	联系技术支持。
400	APIC.0602	Bad request.	检查请求是否合法。
500	APIC.0605	Backend domain name resolution failed.	检查域名拼写，以及域名是否绑定了正确的后端地址。
500	APIC.0606	Failed to load the API configurations.	联系技术支持。
400	APIC.0607	The following protocol is supported: {xxx}	改用支持的协议（HTTP/HTTPS）访问。
500	APIC.0608	Failed to obtain the admin token.	联系技术支持。
500	APIC.0609	The VPC backend does not exist.	联系技术支持。
502	APIC.0610	No backend available.	检查所有后端是否可用。
500	APIC.0611	The backend port does not exist.	联系技术支持。
500	APIC.0612	An API cannot call itself.	修改API后端配置，递归调用层数不能超过10层。
500	APIC.0705	Backend signature calculation failed.	联系技术支持。

父主题： 调用API

上一篇：查看API调用日志

下一篇：响应消息头

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

附录：API错误码

意见反馈

文档内容是否对您有帮助？

文档反馈