HTTP response status codes - XBOX Game Development Documentation

이 문서에서는 전역 HTTP 응답 상태 코드와 그 의미를 나열합니다. 또한 일반적으로 모든 PlayFab API에 적용되는 추가 설명도 포함되어 있습니다. HTTP 웹 요청 관련 문제를 해결할 때 이 페이지를 참고 가이드로 활용하세요. 특정 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 참조 설명서

​함께 보기

함께 보기