状态响应代码
HTTP 响应可返回以下状态代码。
HTTP 代码 |
HTTP 说明 |
备注 |
2xx |
确定 |
不是错误信息;成功时返回此项。这也应用于业务逻辑失败的情况(例如,CreateBookingResponse 中的 booking_failure 已填充) |
400 |
请求无效 |
请求无效/参数无效(未找到商家、服务和空档,尝试预订无效空档、取消不存在的预订)。 |
401 |
未经授权 |
未通过身份验证(凭据无效,请重试登录)。请求没有执行相应操作的有效身份验证凭据。 |
403 |
禁止 |
权限被拒绝/禁止(调用方已知且被拒)。如果遭拒的原因是部分资源已用尽,则不得使用此响应(请改用 Too Many Requests 来表示此类错误)。
如果无法识别调用方,则不得使用 Forbidden (请改用 Unauthorized 来表示此类错误)。 |
404 |
未找到 |
未找到(未找到相应资源;网址无效;包含无效的 RPC) |
409 |
冲突 |
操作已中止,通常是由于序列器检查失败或事务中止等并发问题。 |
429 |
请求过多 |
部分资源已用尽,可能是每用户配额不足,也可能是整个文件系统的存储空间已用完。 |
499 |
客户关闭了请求 |
操作已取消(通常是被调用者取消)。 |
500 |
内部服务器错误 |
内部错误。这意味着底层系统所期望的一些不变量已损坏。此错误代码保留用于严重错误。 |
501 |
未实现 |
操作在此服务中未实现或不受支持/未启用。 |
503 |
服务不可用 |
该服务目前不可用。这很可能是一种暂时情况,可以通过退避重试来纠正。 |
504 |
网关超时 |
期限已到,但操作尚未完成。对于更改系统状态的操作,即使操作已成功完成,也可能会返回此错误。例如,服务器的成功响应延迟时间过长,截止期限已过。 |
有时可能有多个错误代码都适用。服务应返回适用且最具体的错误代码。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-11-26。
[null,null,["最后更新时间 (UTC):2024-11-26。"],[[["This document outlines the various HTTP status codes that can be returned in responses, categorized as 2xx (Success), 4xx (Client errors), and 5xx (Server errors)."],["2xx codes signify successful operations, including successful business logic failures."],["4xx codes indicate client-side issues such as bad requests, authentication failures, unauthorized access, or resource unavailability."],["5xx codes represent server-side problems, ranging from internal errors and unimplemented features to service unavailability and gateway timeouts."],["When multiple error codes apply, the service should prioritize returning the most specific and relevant code to the situation."]]],[]]