HTTP 状态代码

<ph type="x-smartling-placeholder"></ph> 您正在查看 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 be known Proxy for host: <virtual host name>和 url：<路径>。
405 方法未获允许。您指定了一种不受支持的方法。例如，您在需要 POST 动词的 API 调用中使用了 GET 动词。
409 冲突。表示与现有实体冲突。例如，您尝试使用已存在的名称创建缓存。
415 媒体类型不受支持。通常，此错误发生在 POST 或 PUT 上 在 Content-type HTTP 标头设为错误值时发送响应请求。例如： 如果您将以下内容 POST 到仅支持 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 请求数量过多。速率限制原为 超过配额或尖峰逮捕政策。超出 速率限制为 500，但将来可能会更改为 429。请参阅高峰政策和配额政策，了解如何 请将 500 改为 429
500 请参阅 500 内部服务器错误。
502 请参阅 502 Bad Gateway（502 网关无效）。
503 请参阅 503 Service Unavailable。
504 请参阅 504 网关超时。