Marketplace 리뎀션 오류 처리

마켓플레이스 리뎀션 API를 사용할 때는 강력한 오류 처리가 매우 중요합니다. 이 문서에서는 일반적인 오류 코드 이해에서 원활한 오류 복구 전략 구현에 이르기까지 오류 처리를 위한 모범 사례를 살펴봅니다. 오류는 표준 PlayFab Error Wrapper를 사용하여 반환됩니다.

APIErrorWrapper

APIErrorWrapper는 모든 실패한 API 응답에 대한 래퍼입니다.

이름	형식	설명
code	integer	숫자 HTTP 코드.
error	string	PlayFab 오류 코드.
errorCode	integer	숫자 PlayFab 오류 코드.
errorDetails	object	요청 개체의 개별 문제에 대한 자세한 설명.
errorMessage	string	PlayFab errorCode에 대한 설명.
status	string	문자열 HTTP 코드.

마켓플레이스 관련 문제의 경우 errorDetails 개체에 Key-Value Pair(KVP)를 반환합니다.

이름	형식	설명
MarketplaceErrorCode	string[]	마켓플레이스 호출이 실패한 경우 마켓플레이스에서 반환된 오류 코드. 배열의 첫 번째 문자열은 오류 코드입니다. 두 번째 문자열은 사용 가능한 경우 오류 메시지입니다.

이는 마켓플레이스에서 반환한 오류 코드 및 오류 코드 메시지의 통과 전달입니다.

오류 응답은 아래와 같이 표시됩니다. 개발자는 wrapper.errorDetails['MarketplaceErrorCode']가 null이 아닌지 확인한 다음 첫 번째 요소를 구문 분석하여 다양한 마켓플레이스 오류 코드를 적절하게 처리해야 합니다.

"{
    "code":503,
    "errorDetails":
    {
        "MarketplaceErrorCode":["1234","sample error code"]
    },
    ...    
}"

공개 실패 HTTP 상태 코드

이 섹션에는 redeem API에서 반환된 오류 코드가 나열됩니다.

400 - Bad Request
- 모든 요청 및 입력 검증 실패 GenericErroCodes.InvalidRequest
- 모든 구성 검증 실패 GenericErrorCodes.InvalidServiceConfiguration
- 모든 마켓플레이스 인증 실패
  - GenericErrorCodes.InvalidServiceConfiguration - 서비스 ID 실패와 관련.
  - GenericErrorCodes.InvalidAuthToken - 플레이어 ID 실패와 관련.
- 모든 카탈로그 아이템 구성 실패 GenericErrorCodes.InvalidCatalogItemConfiguration
401/403 - Not Authorized/Forbidden
- PlayFab 인증 실패 GenericErrorCodes.NotAuthorized
503 - MarketplaceUnavailable
- GenericErrorCodes.DownstreamServiceUnavailable

XBOX Services

PlayFab

Marketplace 오류 처리

Marketplace 리뎀션 오류 처리

APIErrorWrapper

공개 실패 HTTP 상태 코드

​Marketplace 리뎀션 오류 처리

​APIErrorWrapper

​공개 실패 HTTP 상태 코드

Marketplace 리뎀션 오류 처리

APIErrorWrapper

공개 실패 HTTP 상태 코드