HTTP 状态代码

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

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

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

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

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

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

请确保您使用的是贵组织的正确凭据，并仔细检查拼写。
404 未找到。验证请求网址是否拼写正确，以及您尝试访问的 API 是否存在。例如，请确保您没有尝试访问错误的 API 修订版本。另请参阅 404 Cannot Identity for host: <virtual host name> and url: <path>。
405 方法未获允许。您指定的方法不受支持。例如，您将 GET 动词用于需要 POST 动词的 API 调用。
409 冲突。表示与现有实体冲突。例如，您尝试使用已存在的名称创建缓存。
415 媒体类型不受支持。通常，当 Content-type HTTP 标头设置为错误值时，POST 或 PUT 请求会发生此错误。例如，如果将以下内容发布到仅支持 JSON 的 API，系统会返回 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 服务不可用。
504 请参阅 504 网关超时。