HTTP 状态代码

您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 info

Edge API 响应错误消息包含 HTTP 状态代码和错误消息。

例如，如果您尝试创建与现有缓存同名的缓存实体，则 响应为：

HTTP/1.1 409 Conflict
{
  "code": "messaging.config.beans.CacheAlreadyExists",
  "message": "Cache duplicate_cache already exists in environment test",
  "contexts": []
}

下表总结了最常见的 HTTP 状态代码及其在 Apigee Edge 中的含义。

HTTP 状态代码 说明
2xx 成功。API 调用成功。HTTP 204 表示响应已 提交，但没有内容，通常是因为成功执行了 DELETE 操作。
401 未经授权。您用于发出请求的凭据没有执行该操作的相应权限。请验证所使用账号的角色。
403 已禁止。您所使用的用户名和 密码组合对您指定的组织无效。如需测试您的 凭证，请登录login.apigee.com/login。如果您需要账号，注册。

请确保您使用的是贵组织的正确凭证，并仔细检查拼写。
404 找不到。请验证请求网址的拼写是否正确，以及您尝试访问的 API 是否存在。例如，确保您尝试访问的 API 修订版本没有错误。另请参阅 404：无法识别主机“<virtual host name>”和网址“<path>”的代理。
405 不允许使用的方法。您指定的方法不受支持。例如，对于需要 POST 动词的 API 调用，您使用了 GET 动词。
409 冲突。此错误表示与现有实体发生冲突。例如，您尝试使用已存在的名称创建缓存。
415 媒体类型不受支持。通常情况下，当 Content-type HTTP 标头的值设置错误时，会在 POST 或 PUT 请求中发生此错误。例如， 如果您向仅支持 JSON 的 API POST 以下内容，则会返回 HTTP 415 错误： 
$ curl https://api.company.com/v1/json_service
  -X POST
  -H "Content-type:text/xml"
  -d '<SomeXML>'

对于 GET 请求，请使用 Accept 标头，而不是 Content-type 标头。
429 请求过多。超出了配额或 Spike Arrest 政策的速率限制。目前，超出 速率限制的默认状态代码为 500，但将来可能会更改为 429。如需了解如何将 500 更改为 429，请参阅 Spike Arrest 政策和 配额政策。
500 请参阅 500 内部服务器错误。
502 请参阅 502 网关无效。
503 请参阅 503 Service Unavailable。
504 请参阅 504 Gateway Timeout。