错误码对照表

本文描述 API 的公共错误返回，与对应的解决方法。公共错误与具体业务接口无关，一般为公共参数的缺失，项目状态异常，签名失败，或业务流控触发等场景返回。

公共错误的返回格式

错误触发后，Response Body 会输出错误的详细信息，内容为JSON格式的字符串，包括字段：

error：错误的唯一代码，可以作为错误的识别标识，公共错误统一以 "oray_paas/" 作为前缀

msg：详细的错误信息，供开发人员阅读的自然语言信息

例：

{
  "error": "oray_paas/missing_app_key",
  "msg": "missing required HTTP header parameter [X-OPA-APP-KEY]"
}

错误代码	HTTP Status code	说明
oray_paas/missing_app_key	400	缺少 AppKey 参数，详见平台签名校验
oray_paas/app_status_exception	403	应用项目状态异常，请检查以下内容 1. AppKey 参数是否传入错误 2. AppKey 对应的项目状态是否正常
oray_paas/invalid_request_signature	403	签名校验失败，无效的签名，详见平台签名校验，检查请求参数
oray_paas/limit_exceeded	429	请求频率超过应用服务限制，配合 Retry-After 响应头处理重试
oray_paas/check_permission_failed	403	检查调用权限异常，请检查以下内容 1. AppKey 对应的项目是否开启IP白名单，请求IP是否在白名单之内 2. AppKey 对应的项目下的相关API产品是否授权，是否在有效期之内
oray_paas/duplicate_nonce	403	重复的随机串，详见平台签名校验
oray_paas/service_deplicated	404	指定的 API（版本）已弃用，参见相关产品文档以、公告或服务通知

见具体的API接口文档