Web 服务方法 › REST HTTP 方法 › HTTP 状态和错误代码

HTTP 状态和错误代码

每个 HTTP 响应包含一个 HTTP 状态代码。 成功的 HTTP 响应代码号范围从 200 至 399。 标准 HTTP 错误响应代码号范围从 400 到 599。

以下列表显示了 REST API 针对每个 HTTP 方法返回的成功和错误代码号。

GET（单个）

200, 400, 401, 404, 409

GET（集合）

200, 400, 401

PUT

200, 400, 401, 404, 409

删除

204, 400, 401, 409

POST

201, 400, 401, 409

注意：对于 PUT 和 DELETE 操作，API 最初不会尝试确定 ID 的有效性。 相反，API 会尝试直接运行更新和删除查询。 如果发生错误，API 将返回 409 冲突代码。 如果 API 在这种情况下返回 404 未找到代码，则性能降低。

此外，将在以下情况下返回下列错误消息：

• 如果 HTTP 请求包含无效或不可访问的 URI 地址，服务器会响应 404 未找到响应代码。
• 如果 HTTP 请求对于有效的 URI 包含不受支持的 HTTP 方法，服务器会响应 405 不允许的方法响应代码。
• 如果 HTTP 请求要请求不受支持的介质类型（“接收”头），服务器会响应 406 不可接受响应代码。
• 如果 HTTP 请求发送不受支持的介质类型（“内容类型”头），服务器会响应 415 不支持的媒体类型响应代码。
• 各种语法或内部 Web 服务器错误可能返回 500 内部错误。