> ## 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 response status codes.

이 문서에서는 전역 HTTP 응답 상태 코드와 그 의미를 나열합니다. 또한 일반적으로 모든 PlayFab API에 적용되는 추가 설명도 포함되어 있습니다.

HTTP 웹 요청 관련 문제를 해결할 때 이 페이지를 참고 가이드로 활용하세요. 특정 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

- [Standard HTTP status codes](https://docs.xbox.com/ko/reference/live/rest/additional/httpstatuscodes.md)
- [POST (/users/xuid({xuid})/achievements/{scid}/update)](https://docs.xbox.com/ko/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdatepost.md)
- [PUT (/users/me/gamerpic)](https://docs.xbox.com/ko/reference/live/rest/uri/gamerpic/uri-usersmegamerpicput.md)
- [GET (/ext/unattendedsetup/configure)](https://docs.xbox.com/ko/reference/deviceportal/unattendedsetup/uri-extunattendedsetupconfigure-get.md)
- [POST (/ext/unattendedsetup/configure)](https://docs.xbox.com/ko/reference/deviceportal/unattendedsetup/uri-extunattendedsetupconfigure-post.md)
