​

快速入门：适用于 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”]

​

获取 Title 实体令牌

与 PlayFab 的实体编程模型交互的一种方式是获取 Title 实体令牌。当您想要更改游戏配置数据，或者想要对大量玩家进行调整时，这非常有用：

• 在 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”]

​

故障排除

• Title ID 与密钥不匹配
  • 如果您尝试获取 Title 实体令牌但收到 401: Unauthorized 错误，请通过登录 Game Manager 确认 title ID 和密钥是否正确
• 过期的实体令牌
  • 如果您之前获取了实体令牌但尝试调用其他 API 均失败，则您的实体令牌可能已过期。获取另一个实体令牌，将其保存到 EntityToken 环境变量中，然后重新尝试调用之前的 API
• 实体令牌类型不正确
  • 存在不同类型的实体（请参阅 可用的内置实体类型）。不同的 API 允许不同的实体类型 - 例如，您可能正在尝试使用 title_player_account 实体令牌而非 title 实体令牌来调用 GetLanguageList
• 环境不正确：
  • 通过检查环境下拉列表（窗口右上角）确保您使用的是正确的环境

​

后续步骤

您现在拥有可传递到其他 API 调用的实体令牌，可以开始设置您的 PlayFab 游戏。