所有响应都包含 HTTP 状态代码和接受标头,除非状态代码为 204(无内容)。响应内容取决于请求。某些响应包含文档正文,某些响应仅包含 URL,而某些响应为空。
HTTP 响应代码
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 指定的上游服务器收到及时响应。 |