所有响应都包含 HTTP 状态代码和接受标头,除非状态代码为 204(无内容)。响应内容取决于请求。某些响应包含文档正文,某些响应仅包含 URL,而某些响应为空。

HTTP 响应代码

API 客户端可能会在响应中获得一小部分 HTTP 状态代码。

表 1. API 返回的 HTTP 状态代码
状态代码 状态说明
200 正常 请求有效且已完成。响应包含文档正文。
201 已创建 请求有效。请求的对象已创建,可以在位置标头中指定的 URL 处找到。
202 已接受 请求有效,并已创建任务来进行处理。此响应通常附带 TaskStatus 元素。
204 无内容 请求有效且已完成。响应不包含正文。
400 错误请求 请求正文格式错误、不完整或无效。
401 未授权 登录失败或身份验证令牌已过期。
403 已禁止 用户未通过身份验证,或者没有足够的特权来访问请求中指定的一个或多个对象。
404 未找到 未找到请求中指定的对象。
405 不允许使用此方法 此对象不支持请求中指定的 HTTP 方法。
406 不可接受 请求识别的资源无法生成请求的 Accept 标头中指定类型的响应。
415 不支持的媒体类型 请求识别的资源不支持指定的 Content-Type 请求和 HTTP 方法。
422 未找到 通常表示格式错误的请求 URL 或请求正文。
429 请求太多 一个客户端发送了太多请求,或者多个客户端同时发送了太多请求,并且服务器由于速率限制而无法处理这些请求。

要解决此问题,请稍后尝试再次发送请求。

500 内部服务器错误 请求已收到,但由于服务器上的内部错误,无法完成。
503 服务不可用 由于资源耗尽或服务器维护等临时状况,服务器当前无法处理请求。
504 网关超时 充当网关或代理的服务器未从请求 URL 指定的上游服务器收到及时响应。