빠른 시작: Postman용 PlayFab REST API 컬렉션

  • 아티클

Postman용 PlayFab REST API 컬렉션을 시작합니다. 단계에 따라 패키지를 설치하고 예제 코드를 통해 기본 작업을 수행해 봅니다. PlayFab은 라이브 게임을 위한 완벽한 백 엔드 플랫폼입니다. Postman용 PlayFab REST API 컬렉션을 사용하여 다음을 수행합니다.

  • 엔터티 토큰 가져오기
  • 타이틀에서 엔터티 추가/수정/삭제
  • 타이틀 콘텐츠 구성

API 참조 설명서 | PlayFab Postman Collection GitHub 리포지토리

필수 구성 요소

PlayFab 컬렉션 추가

  • 작업 영역 만들기

    Postman 작업 영역 만들기 선택

    Postman 작업 영역 만들기

  • 가져오기(창 왼쪽 상단) 선택

    Postman 가져오기

  • 링크 선택

    Postman 링크에서 가져오기 선택

    Postman 링크에서 가져오기

  • 다음 링크를 URL 텍스트 상자에 붙여넣고 계속 및 가져오기를 선택합니다.

    https://raw.githubusercontent.com/PlayFab/PostmanCollection/master/playfabV2.json

    • 베타 SDK를 다운로드하려는 경우 Postman 베타 GitHub 리포지토리에서 playfabV2.json 파일로 이동합니다.

    • 원시 보기 선택

      Postman 원시 베타 JSON 보기

    • 브라우저에서 URL을 복사하고 URL 텍스트 상자에 링크를 붙여넣고 계속 및 가져오기를 선택합니다.

  • 이제 컬렉션 탭(창의 왼쪽 위)에서 PlayFab Postman SDK가 표시됩니다.

    Postman PlayFab 컬렉션

환경 변수 추가

  • 환경 및 환경 만들기를 선택하여 새 환경을 만듭니다.

    Postman 환경 관리

  • 환경 이름 지정 - "[titleId] - 테스트 환경" 권장

참고 항목

게임 관리자에 로그인하고 내 스튜디오 및 타이틀 기본 페이지에서 타이틀 이름 아래에 16진수 값을 복사하여 타이틀 ID를 찾을 수 있습니다.

  • 환경에 다음 3개의 변수를 추가합니다.

    변수 초기 값 현재 값
    TitleId [titleId] [titleId]
    SecretKey [secretKey] [secretKey]
    EntityToken

참고 항목

비밀 키 관리 설명서에서 타이틀 비밀 키 및 해당 키를 찾을 위치에 대해 자세히 알아볼 수 있습니다.

Postman 환경 만들기

  • 완료되면 저장 을 선택하여 새 환경을 저장합니다.

  • 환경 관리 창에서 종료하고 환경 드롭다운을 선택하여 새 환경(창의 오른쪽 위)으로 전환

    Postman 환경 선택

타이틀 엔터티 토큰 가져오기

PlayFab의 엔터티 프로그래밍 모델과 상호 작용하는 한 가지 방법은 타이틀 엔터티 토큰을 가져오는 것입니다. 이 방법은 타이틀 구성 데이터를 변경하거나 많은 수의 플레이어를 조정하려는 경우에 유용할 수 있습니다.

  • PlayFab 컬렉션 폴더에서 인증 네임스페이스를 확장하고 GetEntityToken을 선택합니다.

  • 헤더에서 X-Authorization 선택을 취소합니다.

    Postman 엔터티 토큰 헤더 가져오기

  • 보내기 선택

  • 반환된 엔터티 토큰을 EntityToken 환경 변수로 설정

    • 응답에서 EntityToken 문자열을 강조 표시합니다.

    • 마우스 오른쪽 단추를 클릭하고 새 환경에 대해 설정: [환경]을 선택합니다.

    • EntityToken 선택

      Postman 엔터티 토큰 변수 설정

참고 항목

엔터티 토큰은 24시간 후에 만료됩니다. 나중에 GetEntityToken을(를) 다시 실행하여 새 엔터티 토큰을 가져오고 환경 변수를 업데이트해야 합니다.

Title_Player_Account 엔터티 토큰 가져오기

PlayFab의 엔터티 프로그래밍 모델과 상호 작용하는 또 다른 방법은 Title_Player_Account 엔터티 토큰을 가져오는 것입니다. 이는 단일 플레이어를 변경하려는 경우에 유용합니다.

  • PlayFab 컬렉션 폴더에서 클라이언트 네임스페이스를 확장하고 LoginWithCustomID를 선택합니다.
  • 본문에서 CreateAccount 값을 false에서 true로 변경합니다.
  • 보내기 선택
  • 반환된 엔터티 토큰을 EntityToken 환경 변수로 설정

    • 응답에서 EntityToken 문자열을 강조 표시합니다.

    • 마우스 오른쪽 단추를 클릭하고 새 환경에 대해 설정: [환경]을 선택합니다.

    • EntityToken 선택

      Postman Title_Player_Account 엔터티 토큰 받기

문제 해결

  • 타이틀 ID/비밀 키 불일치
    • 타이틀 엔터티 토큰을 가져오고 401: Unauthorized 오류가 발생하는 경우 게임 관리자에 로그인하여 타이틀 ID와 비밀 키가 올바른지 확인합니다.
  • 만료된 엔터티 토큰
    • 이전에 엔터티 토큰을 가져오고 다른 API를 호출하지 못한 경우 엔터티 토큰이 만료되었을 수 있습니다. 다른 엔터티 토큰을 가져오고 EntityToken 환경 변수에 이를 저장한 다음 이전 API를 다시 호출합니다.
  • 잘못된 엔터티 토큰 형식
    • 다양한 유형의 엔터티(사용 가능한 기본 제공 엔터티 형식 참조)가 있습니다. 다른 API를 사용하면 다양한 엔터티 형식을 사용할 수 있습니다. 예를 들어 타이틀 엔터티 토큰 대신 title_player_account 엔터티 토큰으로 GetLanguageList을(를) 호출하려고 할 수 있습니다.
  • 잘못된 환경:
    • 환경 드롭다운(창의 오른쪽 위)을 확인하여 올바른 환경을 사용하고 있는지 확인합니다.

다음 단계

이제 PlayFab 타이틀 설정을 시작하기 위해 다른 API 호출에 전달할 엔터티 토큰이 있습니다.

PlayFab 빠른 시작 >

API 참조 >