HTTP 响应状态代码 - XBOX Game Development Documentation

本文列出全局 HTTP 响应状态代码及其含义，并附有通常适用于所有 PlayFab API 的补充说明。请将本页面作为参考指南，用于排查与 HTTP Web 请求相关的问题。若要查看与特定 API 相关的具体说明，请转到该 API 的文档页面。如果您遇到未在此处列出的状态代码，请在 PlayFab 论坛上告知我们，并将问题归类到 API and SDK questions 下。

并非所有 API 都会返回下方列出的全部状态代码。有些 API 只会返回其中的部分代码。

HTTP 状态代码	常规说明
100	Continue：在 HEAD 请求上返回
200	OK：在所有成功请求上返回。对于批量 API，可能表示部分成功。
201	Created：请求成功且资源已创建。
202	Accepted：请求成功，处理将异步继续。
204	No Content：API 成功，但该 API 没有需要返回的响应。
400	Bad Request：请求中的参数无效或请求负载结构无效。请勿重试。
401	Unauthorized：调用方无权调用特定 API 或执行所请求的操作。请勿重试。
403	Forbidden：不允许调用方访问。请勿重试。
404	Not Found：API 不存在。请勿重试。
408	Request Timeout：请求发送到服务器所花费的时间过长。可以使用指数退避模式进行重试。
409	Conflict：两次 API 调用之间发生并发错误。可以使用指数退避模式进行重试。
413	Payload Too Large：请求超出服务器允许的处理大小。请勿重试。如果出现意外情况，请联系支持人员。
414	URI Too Long：请求中的 URI 超出服务器允许处理的长度。请勿重试。
429	Too Many Requests：API 调用受到速率限制。请暂停后再重试请求，并检查 API 是否返回“Retry-After”标头或 JSON 响应中的 retryAfter 字段，以获取所需的延迟时间。
500	Internal Server Error：PlayFab 服务器上发生错误。可以重试；如果问题仍然存在，请联系支持人员。
501	Not Implemented：所调用的 API 尚未实现。请勿重试。
502	Bad Gateway：PlayFab API 服务器无法处理该请求。请暂停后使用指数退避模式重试请求。
503	Service Unavailable：PlayFab API 服务器无法处理该请求。请暂停后使用指数退避模式重试请求。
504	Gateway Timeout：PlayFab API 服务器无法处理该请求。请暂停后再重试请求。

另请参阅

PlayFab API 参考文档

最后修改于 2026年8月13日

​另请参阅

另请参阅