- Code - 서버에서 반환된 HTTP 오류 코드
- ErrorCode - PlayFab 전용 숫자 오류 코드입니다.
- Error - PlayFab 전용의 사람이 읽을 수 있는 코드입니다.
- ErrorMessage - 디버깅에 유용한 추가 컨텍스트를 제공하는 오류에 대한 설명입니다.
- ErrorDetails - 항상 존재하지는 않습니다. 특정 유형의 오류에 대한 추가 컨텍스트를 제공합니다.
이 페이지에는 발생할 수 있는 일반적인 오류 코드가 나열되어 있습니다. 찾고 있는 오류 코드가 이 페이지에 없는 경우, 보다 일반적인 HTTP 응답 상태 코드 안내를 참조하세요.
재시도해도 안전한 코드
일반적으로 이러한 오류 코드로 실패한 요청은 지수 지연 백오프를 사용하여 재시도해도 안전합니다. 이러한 오류는 일반적으로 클라이언트가 호출을 너무 빠르게 하고 있음을 의미하지만, 요청 자체는 유효할 수 있습니다.APIClientRequestRateLimitExceeded (1199): 짧은 시간 동안 호출이 너무 많음을 나타냅니다.APIConcurrentRequestLimitExceeded (1342): 동시 호출이 너무 많음을 나타냅니다.ConcurrentEditError (1133): 동시 호출이 너무 많거나 매우 빠른 순차적 호출을 나타냅니다.DataUpdateRateExceeded (1287): _동시 호출_이 너무 많거나 매우 빠른 순차적 호출을 나타냅니다.DownstreamServiceUnavailable (1127): PlayFab 또는 타사 서비스에 일시적인 문제가 있을 수 있음을 나타냅니다.ServiceUnavailable (1123): PlayFab에 일시적인 문제가 있거나 클라이언트가 너무 빠르게 API 호출을 하고 있음을 나타냅니다. 이 요청을 재시도하는 경우, 지수 백오프 전략을 적절히 사용하는 것이 중요합니다.
재시도하지 말아야 할 코드
이러한 오류 코드가 발생하면 절대 재시도해서는 안 됩니다. 버그 수정이나 설정 변경 없이는 현재 상황에서 요청을 완료할 수 없기 때문입니다. API 메서드와 함께 나열된 대부분의 구체적인 코드도 이 범주에 속합니다.AccountBanned (1002):
플레이어 계정이 차단되었으며, 모든 API 메서드가 이 오류로 실패합니다.AccountDeleted (1322): 플레이어 계정이 삭제되었으며, 모든 API 메서드가 이 오류로 실패합니다.AccountNotFound (1001): 플레이어 계정이 존재하지 않습니다.PlayFabId/TitlePlayerId를 올바르게 복사하지 않았을 가능성이 큽니다. 이 오류는 식별자가 올바르지 않은 경우 항상 발생합니다.APIRequestsDisabledForTitle (1295): 이 타이틀에 대한 모든 API 요청이 비활성화되었으며 더 이상 사용할 수 없습니다.InvalidContentType (1144): 저희 SDK 중 하나를 사용하는 경우 이 오류가 발생하는 것은 불가능합니다. PlayFab API 메서드에 대해 직접 원시 HTTPS 호출을 하는 경우,Content-Type헤더는 반드시application/json이어야 합니다. 다른 형식은 허용되지 않습니다.InvalidEntityType (1373): 인증에 사용된 토큰의 엔티티 유형이 이 API에서 지원되지 않습니다.InvalidParams (1000): PlayFab에 전송된 API 요청 객체에 잘못된 매개 변수가 있어 실행할 수 없습니다.InvalidRequest (1071): PlayFab에 전송된 API 요청 객체가 잘못되어 실행할 수 없습니다.InvalidTitleId (1004): 요청에서 제공된 TitleId가 메서드의 URL에 제공된 타이틀과 일치하지 않습니다. 대부분의 SDK에서는 로그인 요청에 TitleId를 지정하지 않아야 합니다. 자동으로 처리되기 때문입니다. 관리자 API에서, 명시적인 TitleId는 Dev->Test->Live의 안전 기능입니다.NotAuthenticated (1074): 클라이언트가 먼저 로그인하지 않고SessionTicket인증이 필요한 API를 호출하려고 시도했습니다.NotAuthorized (1089): 잘못된 자격 증명 또는 로그인과 관련된 잘못된 입력입니다.NotAuthorizedByTitle (1191): 이 메서드는 API 정책에 의해 비활성화되었으며 호출할 수 없습니다.ProfileDoesNotExist (1298): 존재하지 않는 엔티티(플레이어, 캐릭터, 타이틀 등)에 접근하려고 시도했습니다. 오타이거나 어딘가에 잘못된 입력이 있을 가능성이 큽니다.TitleDeleted (1347): 이 타이틀은 PlayFab에서 삭제되었으며 더 이상 사용할 수 없습니다.UnknownError (1039): 잘못된 정보가 타사 추가 기능에 전송되고, 서버가 외부 시스템과 상호 작용하는 동안 알 수 없는 결과 또는 오류가 발생한 경우 일반적으로 나타납니다. 이를 해결하려면 입력을 시험해 보고 입력이 어떤 식으로든 잘못되었는지 확인해 보세요. 그렇지 않다면 titleId, 전체 요청 JSON(가능한 경우) 및 오류 출력과 함께 포럼에 오류를 신고하세요. Postman은 이러한 상황을 디버깅하는 데 유용한 도구입니다.InvalidAPIEndpoint (1131): 이 요청의 URL이 이 타이틀에 유효하지 않음을 나타냅니다.OverLimit (1214): 작업 수행 시도가 게임 관리자 제한 페이지에 표시된 대로 서비스 사용량이 한도를 초과하게 됨을 나타냅니다. 반환된 오류 세부 정보를 평가하여 어떤 한도가 초과되는지 확인하세요.
기타 주목할 만한 오류 코드
이러한 코드는 특정 API 메서드에서만 발생하지만(해당 메서드의 문서 페이지에 나열됨), 이러한 코드를 보게 되면 알아두어야 할 중요한 결과가 있습니다.APIConcurrentRequestLimitExceeded (1342): 타이틀이 CloudScript를 너무 자주 사용하고 있거나, 세그먼트 평가를 너무 자주 강제하려고 하거나(또는 둘 다), 그렇지 않다면 두 가지 모두일 수 있습니다. 전자의 경우, 살펴봐야 할 두 가지는 다음과 같습니다:- 스크립트 호출이 호출당 최대 시간에 가깝게(또는 그보다 더 나쁘게, 시간 초과되는) 얼마나 자주 사용되는지.
- 플레이어당 CloudScript를 얼마나 자주 호출하는지. 세그먼트의 플레이어 목록을 가져오는 호출이 확인해야 할 핵심 사항입니다(세그먼트를 대상으로 하는 작업도 재평가를 유발하지만, 자주 발생해서는 안 됩니다).
ConnectionTimeout (2): 사용 중인 SDK의 세부 사항 및 기본 네트워킹 스택에 따라 ConnectionError, ConnectionTimeout 또는 PlayFab 서버 접속의 어려움과 관련된 기타 오류가 나타날 수 있습니다. 이 모든 것은 네트워킹 문제를 나타냅니다. 가장 일반적인 원인은 클라이언트 측의 연결 끊김입니다. 클라이언트와 PlayFab 서버 사이의 인터넷 라우팅이 어떤 이유로 중단된 경우에도 발생할 수 있습니다. 게임이 이러한 오류를 처리하기 위해 할 수 있는 일은 거의 없습니다. 가장 좋은 대응은 상위 호출자 또는 플레이어에게 연결을 설정할 수 없음을 알리는 것입니다. 그런 다음 나중에 작업을 다시 시작할 수 있습니다.