​

快速入門：適用於 Postman 的 PlayFab REST API 集合

開始使用適用於 Postman 的 PlayFab REST API 集合。請依照步驟安裝套件，並試用基本工作的範例程式碼。PlayFab 是適用於即時營運遊戲的完整後端平台。使用適用於 Postman 的 PlayFab REST API 集合來：

• 取得實體權杖
• 在遊戲中新增/修改/刪除實體
• 設定遊戲內容

API 參考文件 | PlayFab Postman 集合 GitHub 存放庫

​

必要條件

• PlayFab 開發人員帳戶
• Postman 原生應用程式
• 執行 TLS 1.2 或更新版本的作業系統 (Windows 對 TLS 1.2 的支援)

​

新增 PlayFab 集合

• 建立工作區

  [!div class=“mx-imgBorder”]

  [!div class=“mx-imgBorder”]

• 選取 Import (視窗左上方)

  [!div class=“mx-imgBorder”]

• 選取 Link

  [!div class=“mx-imgBorder”]

  [!div class=“mx-imgBorder”]

• 將下列連結貼到 URL 文字方塊中，然後選取 Continue 和 Import https://raw.githubusercontent.com/PlayFab/PostmanCollection/master/playfabV2.json
  • 如果您嘗試下載 Beta 版 SDK，請前往 Postman Beta GitHub 存放庫中的 playfabV2.json 檔案
  • 選取 View Raw

    [!div class=“mx-imgBorder”]

  • 從瀏覽器複製 URL，將連結貼到 URL 文字方塊中，然後選取 Continue 和 Import
• 您現在應該會在 Collections 索引標籤 (視窗左上方) 下看到 PlayFab Postman SDK

  [!div class=“mx-imgBorder”]

​

新增環境變數

• 選取 Environments 和 Create Environment 以建立新環境

  [!div class=“mx-imgBorder”]

• 為您的環境命名 - 建議使用 “[titleId] - Test Environment”

• 將下列 3 個變數新增至環境：

  變數	初始值	目前值
  TitleId	[titleId]	[titleId]
  SecretKey	[secretKey]	[secretKey]
  EntityToken

[!div class=“mx-imgBorder”]

• 完成時，選取 Save 以儲存您的新環境
• 選取環境下拉式清單以切換至您的新環境 (視窗右上方)

  [!div class=“mx-imgBorder”]

​

取得遊戲實體權杖

與 PlayFab 實體程式設計模型互動的其中一種方式是取得遊戲實體權杖。如果您想要變更遊戲設定資料，或想要對大量玩家進行調整，這會很有用：

• 在 PlayFab Collections 資料夾下，展開 Authentication 命名空間，然後選取 GetEntityToken
• 在 Headers 下，取消核取 X-Authorization

  [!div class=“mx-imgBorder”]

• 選取 Send
• 將傳回的實體權杖設定為您的 EntityToken 環境變數
  • 在回應中，反白顯示 EntityToken 字串
  • 按一下滑鼠右鍵，然後為您的新環境選取 Set: [Environment]
  • 選取 EntityToken

    [!div class=“mx-imgBorder”]

​

取得 Title_Player_Account 實體權杖

與 PlayFab 實體程式設計模型互動的另一種方式是取得 Title_Player_Account 實體權杖。如果您想要變更單一玩家，這會很有用：

• 在 PlayFab Collections 資料夾下，展開 Client 命名空間，然後選取 LoginWithCustomID
• 在 Body 下，將 CreateAccount 值從 false 變更為 true
• 選取 Send
• 將傳回的實體權杖設定為您的 EntityToken 環境變數
  • 在回應中，反白顯示 EntityToken 字串
  • 按一下滑鼠右鍵，然後為您的新環境選取 Set: [Environment]
  • 選取 EntityToken

    [!div class=“mx-imgBorder”]

​

疑難排解

• 遊戲識別碼 / 祕密金鑰不符
  • 如果您嘗試取得遊戲實體權杖時收到 401: Unauthorized 錯誤，請登入 Game Manager 確認遊戲識別碼和祕密金鑰是否正確
• 實體權杖已到期
  • 如果您先前已取得實體權杖，但嘗試呼叫其他 API 時失敗，您的實體權杖可能已到期。請取得另一個實體權杖，將其儲存至 EntityToken 環境變數，然後再次嘗試呼叫先前的 API
• 實體權杖類型不正確
  • 實體有不同的類型 (請參閱可用的內建實體類型)。不同的 API 允許不同的實體類型 - 例如，您可能嘗試以 title_player_account 實體權杖 (而非遊戲實體權杖) 呼叫 GetLanguageList
• 環境不正確：
  • 請檢查環境下拉式清單 (視窗右上方)，確定您使用的是正確的環境

​

後續步驟

您現在已擁有實體權杖，可以傳入其他 API 呼叫中，開始設定您的 PlayFab 遊戲。