> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP 响应状态代码

> HTTP 响应状态代码。

本文列出全局 HTTP 响应状态代码及其含义，并附有通常适用于所有 PlayFab API 的补充说明。

请将本页面作为参考指南，用于排查与 HTTP Web 请求相关的问题。若要查看与特定 API 相关的具体说明，请转到该 API 的文档页面。

如果您遇到未在此处列出的状态代码，请在 [PlayFab 论坛](https://community.playfab.com/index.html) 上告知我们，并将问题归类到 **API and SDK questions** 下。

> [!NOTE]
>
> 并非所有 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 参考文档](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/ban-users)


## Related topics

- [全局 API 方法错误代码](https://docs.xbox.com/zh-CN/services/playfab/api-references/global-api-method-error-codes.md)
- [标准 HTTP 状态代码](https://docs.xbox.com/zh-CN/reference/live/rest/additional/httpstatuscodes.md)
- [调用 XBOX 服务的最佳实践](https://docs.xbox.com/zh-CN/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl.md)
- [GET (/json/users/xuid({xuid})/scids/{scid}/data/{path})](https://docs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-jsonusersxuidscidssciddatapath-get.md)
- [GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-jsonusersxuidscidssciddatapathandfilenametype-get.md)