文档首页/应用与数据集成平台 ROMA Connect/用户指南/服务集成APIC使用指导/调用APIC开放的API/APIC的API错误码
更新时间：2025-12-29 GMT+08:00
查看PDF
分享

APIC的API错误码

用户调用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.

联系技术支持。

相关文档