> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 將 PlayFab REST API 集合匯入 Postman、取得實體權杖，並進行您的第一次 PlayFab API 呼叫以管理遊戲和實體。

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

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

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

[API 參考文件](/zh-TW/services/playfab/api-references) | [PlayFab Postman 集合 GitHub 存放庫](https://github.com/PlayFab/PostmanCollection)

## 必要條件

* [PlayFab 開發人員帳戶](https://developer.playfab.com)
* [Postman 原生應用程式](https://www.getpostman.com/)
* 執行 [TLS](https://learn.microsoft.com/en-us/windows/win32/secauthn/transport-layer-security-protocol) 1.2 或更新版本的作業系統 ([Windows 對 TLS 1.2 的支援](https://learn.microsoft.com/en-us/dotnet/framework/network-programming/tls#support-for-tls-12))

### 新增 PlayFab 集合

* 建立工作區

  > \[!div class="mx-imgBorder"]
  >
  > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-create-workspace.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=58f1b69b3ecd8555f1a0afca1535ad2d" alt="Postman 選取建立工作區" width="1149" height="698" data-path="images/playfab/sdks/postman/tutorials/postman-new-create-workspace.png" />

  > \[!div class="mx-imgBorder"]
  >
  > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-create-workspace2.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=050d60c97b0b01e1aeafecc074915757" alt="Postman 建立工作區" width="895" height="664" data-path="images/playfab/sdks/postman/tutorials/postman-new-create-workspace2.png" />

* 選取 **Import** *(視窗左上方)*

  > \[!div class="mx-imgBorder"]
  >
  > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-import.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=a7adb5cef8afb32e9710b916d78f9e64" alt="Postman 匯入" width="1053" height="652" data-path="images/playfab/sdks/postman/tutorials/postman-new-import.png" />

* 選取 **Link**

  > \[!div class="mx-imgBorder"]
  >
  > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-import-from-link.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=932c6fadee2adb727169e0d1945504e4" alt="Postman 選取從連結匯入" width="960" height="405" data-path="images/playfab/sdks/postman/tutorials/postman-new-import-from-link.png" />

  > \[!div class="mx-imgBorder"]
  >
  > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-import-from-link2.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=c31b70428d147e33c27ffa18d8bfb255" alt="Postman 從連結匯入" width="963" height="406" data-path="images/playfab/sdks/postman/tutorials/postman-new-import-from-link2.png" />

* 將下列連結貼到 URL 文字方塊中，然後選取 **Continue** 和 **Import**

  [https://raw.githubusercontent.com/PlayFab/PostmanCollection/master/playfabV2.json](https://raw.githubusercontent.com/PlayFab/PostmanCollection/master/playfabV2.json)

  * 如果您嘗試下載 Beta 版 SDK，請前往 [Postman Beta GitHub 存放庫](https://github.com/PlayFab/PostmanCollection/blob/master/playfabV2.json)中的 playfabV2.json 檔案
  * 選取 **View Raw**

    > \[!div class="mx-imgBorder"]
    >
    > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-view-raw-beta.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=635f9dc8a0462d10dde5642e3b6e8189" alt="Postman 檢視原始 Beta JSON" width="2058" height="822" data-path="images/playfab/sdks/postman/tutorials/postman-new-view-raw-beta.png" />
  * 從瀏覽器複製 URL，將連結貼到 URL 文字方塊中，然後選取 **Continue** 和 **Import**

* 您現在應該會在 Collections 索引標籤 *(視窗左上方)* 下看到 PlayFab Postman SDK

  > \[!div class="mx-imgBorder"]
  >
  > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-playfab-collection.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=cc226a593dc36abf593f5ad14d6fda19" alt="Postman PlayFab 集合" width="1186" height="747" data-path="images/playfab/sdks/postman/tutorials/postman-new-playfab-collection.png" />

### 新增環境變數

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

  > \[!div class="mx-imgBorder"]
  >
  > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-manage-environments.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=7fe989a8953a431028c949ae7e715d1c" alt="Postman 管理環境" width="1096" height="670" data-path="images/playfab/sdks/postman/tutorials/postman-new-manage-environments.png" />

* 為您的環境命名 - 建議使用 "\[titleId] - Test Environment"

<Note>
  若要找到您的遊戲識別碼，請登入 [Game Manager](https://developer.playfab.com/en-us/my-games)，並複製 **My Studios and Titles** 主頁面上遊戲名稱下方的十六進位值。
</Note>

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

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

<Note>
  您可以在[祕密金鑰管理](/zh-TW/services/playfab/live-service-management/gamemanager/secret-key-management)文件中深入了解遊戲祕密金鑰及其位置。
</Note>

> \[!div class="mx-imgBorder"]
>
> <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-create-environment.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=1d6439335221c76e00c3a5c7929e83f2" alt="Postman 建立環境" width="1294" height="719" data-path="images/playfab/sdks/postman/tutorials/postman-new-create-environment.png" />

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

  > \[!div class="mx-imgBorder"]
  >
  > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-select-environment.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=1471e53d57d26db273e61536f5b21264" alt="Postman 選取環境" width="892" height="458" data-path="images/playfab/sdks/postman/tutorials/postman-new-select-environment.png" />

### 取得遊戲實體權杖

與 PlayFab [實體程式設計模型](/zh-TW/services/playfab/live-service-management/game-configuration/entities)互動的其中一種方式是取得遊戲實體權杖。如果您想要變更遊戲設定資料，或想要對大量玩家進行調整，這會很有用：

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

  > \[!div class="mx-imgBorder"]
  >
  > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-get-entity-token-header.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=7e7890895183544eab6c097b2c94d3d4" alt="Postman 取得實體權杖標頭" width="850" height="471" data-path="images/playfab/sdks/postman/tutorials/postman-new-get-entity-token-header.png" />
* 選取 **Send**
* 將傳回的實體權杖設定為您的 `EntityToken` 環境變數
  * 在回應中，反白顯示 `EntityToken` 字串
  * 按一下滑鼠右鍵，然後為您的新環境選取 **Set: \[Environment]**
  * 選取 **EntityToken**

    > \[!div class="mx-imgBorder"]
    >
    > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-set-entity-token-variable.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=e851231c2d0e67761921b97ff8ec134f" alt="Postman 設定實體權杖變數" width="1294" height="594" data-path="images/playfab/sdks/postman/tutorials/postman-new-set-entity-token-variable.png" />

<Note>
  實體權杖會在 **24 小時**後到期。之後，您需要重新執行 `GetEntityToken` 以取得新的實體權杖，並更新您的環境變數
</Note>

### 取得 Title\_Player\_Account 實體權杖

與 PlayFab [實體程式設計模型](/zh-TW/services/playfab/live-service-management/game-configuration/entities)互動的另一種方式是取得 Title\_Player\_Account 實體權杖。如果您想要變更單一玩家，這會很有用：

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

    > \[!div class="mx-imgBorder"]
    >
    > <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/postman/tutorials/postman-new-get-title_player_account-entity-token.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=e9915281fac1e2ce246ff13f0f94dcf3" alt="Postman 取得 Title_Player_Account 實體權杖" width="1298" height="729" data-path="images/playfab/sdks/postman/tutorials/postman-new-get-title_player_account-entity-token.png" />

## 疑難排解

* 遊戲識別碼 / 祕密金鑰不符
  * 如果您嘗試取得遊戲實體權杖時收到 `401: Unauthorized` 錯誤，請登入 [Game Manager](https://developer.playfab.com/en-us/my-games) 確認遊戲識別碼和祕密金鑰是否正確
* 實體權杖已到期
  * 如果您先前已取得實體權杖，但嘗試呼叫其他 API 時失敗，您的實體權杖可能已到期。請取得另一個實體權杖，將其儲存至 `EntityToken` 環境變數，然後再次嘗試呼叫先前的 API
* 實體權杖類型不正確
  * 實體有不同的類型 (請參閱[可用的內建實體類型](/zh-TW/services/playfab/live-service-management/game-configuration/entities/available-built-in-entity-types))。不同的 API 允許不同的實體類型 - 例如，您可能嘗試以 title\_player\_account 實體權杖 (而非遊戲實體權杖) 呼叫 `GetLanguageList`
* 環境不正確：
  * 請檢查環境下拉式清單 *(視窗右上方)*，確定您使用的是正確的環境

## 後續步驟

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

<Note>
  \[!div class="nextstepaction"] [PlayFab 快速入門 >](/zh-TW/services/playfab/live-service-management/gamemanager/quickstart) \[!div class="nextstepaction"] [API 參考 >](/zh-TW/services/playfab/api-references)
</Note>


## Related topics

- [適用於原生與 Phaser 的 JavaScript 快速入門](/zh-TW/services/playfab/sdks/javascript/quickstart.md)
- [Unity 快速入門](/zh-TW/services/playfab/sdks/unity3d/quickstart.md)
- [快速入門 - 適用於 C# 的 PlayFab 用戶端程式庫](/zh-TW/services/playfab/sdks/c-sharp/quickstart.md)
- [Unreal Engine 快速入門](/zh-TW/services/playfab/sdks/unreal/quickstart.md)
- [NodeJS 快速入門](/zh-TW/services/playfab/sdks/nodejs/quickstart.md)