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 服务器无法处理请求。 暂停,然后重试请求。

另请参阅