HTTP 响应状态代码
本文列出了全局 HTTP 响应状态代码及其含义。 它还包括通常适用于所有 PlayFab API 的额外说明。
将此页用作参考指南以排查与 HTTP Web 请求相关的问题。 有关与特定 API 相关的特定说明,必须转到该 API 的文档页。
如果收到此处未列出的状态代码,请在PlayFab 论坛中告诉我们,并在API 和 SDK 问题下对问题进行分类。
注意
并非每个 API 都可以返回下面列出的所有状态代码。 有些 API 仅返回部分代码。
HTTP 状态代码 | 常规说明 |
---|---|
100 | 继续:在 HEAD 请求上返回 |
200 | 确定:为所有成功请求返回。 可能指示批量 API 的部分成功。 |
201 | 已创建:请求成功,资源已创建。 |
202 | 接受:请求成功,将继续异步处理。 |
204 | 无内容:API 成功,但不会从 API 返回响应。 |
400 | 请求错误:请求中的参数无效或请求有效负载结构无效。 请勿重试。 |
401 | 未授权:调用方无权调用特定 API 或执行请求的操作。 请勿重试。 |
403 | 禁止:不允许调用方访问。 请勿重试。 |
404 | 未找到:API 不存在。 请勿重试。 |
408 | 请求超时:请求发送到服务器的时间太长。 可以使用指数退避模式重试。 |
409 | 冲突:两个 API 调用之间发生并发错误。 可以使用指数退避模式重试。 |
413 | 有效负载过大:请求大于允许服务器处理的请求。 请勿重试。 如果出现意外,请联系支持人员。 |
414 | URI 太长:请求中的 URI 比允许服务器处理的 URI 长。 请勿重试。 |
429 | 请求过多:API 调用速率有限。 暂停然后重试请求,检查 API 是否在 JSON 响应中返回 了“Retry-After”标头或 retryAfter,以获取所需延迟。 |
500 | 内部服务器错误:PlayFab 服务器上发生错误。 可以重试,如果问题仍然存在,请联系支持人员。 |
501 | 未实现:尚未实现调用的 API。 请勿重试。 |
502 | 网关错误:PlayFab API 服务器无法处理请求。 暂停,然后使用指数回退模式重试请求。 |
503 | 服务不可用:PlayFab API 服务器无法处理请求。 暂停,然后使用指数回退模式重试请求。 |
504 | 网关超时:PlayFab API 服务器无法处理请求。 暂停,然后重试请求。 |