> ## 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.

# Início rápido da coleção da API REST do PlayFab para Postman

> Importe a coleção da API REST do PlayFab no Postman, obtenha um token de entidade e faça sua primeira chamada à API do PlayFab para gerenciar títulos e entidades.

# Início rápido: coleção da API REST do PlayFab para Postman

Comece a usar a coleção da API REST do PlayFab para Postman. Siga as etapas para instalar o pacote e experimentar o código de exemplo para tarefas básicas. O PlayFab é uma plataforma de back-end completa para jogos ao vivo. Use a coleção da API REST do PlayFab para Postman para:

* Obter um token de entidade
* Adicionar/modificar/excluir entidades em um título
* Configurar o conteúdo do título

[Documentação de referência da API](/pt-BR/services/playfab/api-references) | [Repositório da coleção do PlayFab para Postman no GitHub](https://github.com/PlayFab/PostmanCollection)

## Pré-requisitos

* Uma [conta de desenvolvedor do PlayFab](https://developer.playfab.com)
* O [aplicativo nativo do Postman](https://www.getpostman.com/)
* Um SO que execute [TLS](https://learn.microsoft.com/en-us/windows/win32/secauthn/transport-layer-security-protocol) 1.2 ou superior ([suporte do Windows ao TLS 1.2](https://learn.microsoft.com/en-us/dotnet/framework/network-programming/tls#support-for-tls-12))

### Adicionando as coleções do PlayFab

* Crie um workspace

  > \[!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 Select Create Workspace" 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 Create Workspace" width="895" height="664" data-path="images/playfab/sdks/postman/tutorials/postman-new-create-workspace2.png" />

* Selecione **Import** *(no canto superior esquerdo da janela)*

  > \[!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 Import" width="1053" height="652" data-path="images/playfab/sdks/postman/tutorials/postman-new-import.png" />

* Selecione **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 Select Import From Link" 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 Import From Link" width="963" height="406" data-path="images/playfab/sdks/postman/tutorials/postman-new-import-from-link2.png" />

* Cole o link a seguir na caixa de texto de URL e selecione **Continue** e **Import**

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

  * Se você estiver tentando baixar o SDK beta, acesse o arquivo playfabV2.json no [repositório do Postman Beta no GitHub](https://github.com/PlayFab/PostmanCollection/blob/master/playfabV2.json)
  * Selecione **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 View Raw Beta JSON" width="2058" height="822" data-path="images/playfab/sdks/postman/tutorials/postman-new-view-raw-beta.png" />
  * Copie a URL do navegador, cole o link na caixa de texto de URL e selecione **Continue** e **Import**

* Agora você deverá ver o SDK do PlayFab para Postman na guia Collections *(no canto superior esquerdo da janela)*

  > \[!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 Collection" width="1186" height="747" data-path="images/playfab/sdks/postman/tutorials/postman-new-playfab-collection.png" />

### Adicionando variáveis de ambiente

* Selecione **Environments** e **Create Environment** para criar um novo ambiente

  > \[!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 Manage Environments" width="1096" height="670" data-path="images/playfab/sdks/postman/tutorials/postman-new-manage-environments.png" />

* Dê um nome ao ambiente — recomendamos "\[titleId] - Test Environment"

<Note>
  Você pode encontrar o ID do seu título entrando no [Game Manager](https://developer.playfab.com/en-us/my-games) e copiando o valor hexadecimal abaixo do nome do título na página principal **My Studios and Titles**.
</Note>

* Adicione as 3 variáveis a seguir ao ambiente:

  | Variável | Valor inicial | Valor atual |
  | - | - | - |
  | TitleId | \[titleId] | \[titleId] |
  | SecretKey | \[secretKey] | \[secretKey] |
  | EntityToken | | |

<Note>
  Saiba mais sobre as chaves secretas de título e onde encontrá-las na documentação de [Gerenciamento de chaves secretas](/pt-BR/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 Create Environment" width="1294" height="719" data-path="images/playfab/sdks/postman/tutorials/postman-new-create-environment.png" />

* Ao terminar, selecione **Save** para salvar o novo ambiente
* Selecione a lista suspensa de ambientes para alternar para o novo ambiente *(no canto superior direito da janela)*

  > \[!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 Select Environment" width="892" height="458" data-path="images/playfab/sdks/postman/tutorials/postman-new-select-environment.png" />

### Obtendo um token de entidade de título

Uma maneira de interagir com o [modelo de programação de entidades](/pt-BR/services/playfab/live-service-management/game-configuration/entities) do PlayFab é obter um token de entidade de título. Isso pode ser útil se você quiser fazer alterações nos dados de configuração do título ou fazer ajustes em um grande número de jogadores:

* Na pasta **PlayFab Collections**, expanda o namespace **Authentication** e selecione `GetEntityToken`
* Em **Headers**, desmarque `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 Get Entity Token Header" width="850" height="471" data-path="images/playfab/sdks/postman/tutorials/postman-new-get-entity-token-header.png" />
* Selecione **Send**
* Defina o token de entidade retornado na variável de ambiente `EntityToken`
  * Na resposta, realce a cadeia de caracteres `EntityToken`
  * Clique com o botão direito do mouse e selecione **Set: \[Environment]** para o novo ambiente
  * Selecione **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 Set Entity Token Variable" width="1294" height="594" data-path="images/playfab/sdks/postman/tutorials/postman-new-set-entity-token-variable.png" />

<Note>
  Os tokens de entidade expiram após **24 horas**. Depois disso, você precisa executar `GetEntityToken` novamente para obter um novo token de entidade e atualizar sua variável de ambiente
</Note>

### Obtendo um token de entidade Title\_Player\_Account

Outra maneira de interagir com o [modelo de programação de entidades](/pt-BR/services/playfab/live-service-management/game-configuration/entities) do PlayFab é obter um token de entidade Title\_Player\_Account. Isso é útil se você quiser fazer alterações em um único jogador:

* Na pasta **PlayFab Collections**, expanda o namespace **Client** e selecione `LoginWithCustomID`
* Em **Body**, altere o valor de `CreateAccount` de `false` para `true`
* Selecione **Send**
* Defina o token de entidade retornado na variável de ambiente `EntityToken`
  * Na resposta, realce a cadeia de caracteres `EntityToken`
  * Clique com o botão direito do mouse e selecione **Set: \[Environment]** para o novo ambiente
  * Selecione **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 Get Title_Player_Account Entity Token" width="1298" height="729" data-path="images/playfab/sdks/postman/tutorials/postman-new-get-title_player_account-entity-token.png" />

## Solução de problemas

* Incompatibilidade entre ID do título e chave secreta
  * Se você estiver tentando obter um token de entidade de título e receber um erro `401: Unauthorized`, verifique se o ID do título e as chaves secretas estão corretos entrando no [Game Manager](https://developer.playfab.com/en-us/my-games)
* Token de entidade expirado
  * Se você obteve um token de entidade anteriormente e não está conseguindo chamar outras APIs, seu token de entidade pode ter expirado. Obtenha outro token de entidade, salve-o na variável de ambiente `EntityToken` e tente chamar a API anterior novamente
* Tipo de token de entidade incorreto
  * Há diferentes tipos de entidades (consulte [Tipos de entidade internos disponíveis](/pt-BR/services/playfab/live-service-management/game-configuration/entities/available-built-in-entity-types)). APIs diferentes permitem tipos de entidade diferentes — por exemplo, você pode estar tentando chamar `GetLanguageList` com um token de entidade title\_player\_account em vez de um token de entidade de título
* Ambiente incorreto:
  * Verifique se você está usando o ambiente correto conferindo a lista suspensa de ambientes *(no canto superior direito da janela)*

## Próximas etapas

Agora você tem um token de entidade para passar para outras chamadas à API e começar a configurar seu título do PlayFab.

<Note>
  \[!div class="nextstepaction"] [Inícios rápidos do PlayFab >](/pt-BR/services/playfab/live-service-management/gamemanager/quickstart) \[!div class="nextstepaction"] [Referências de API >](/pt-BR/services/playfab/api-references)
</Note>


## Related topics

- [Início rápido da Unreal Engine](/pt-BR/services/playfab/sdks/unreal/quickstart.md)
- [SDK do Postman (REST)](/pt-BR/services/playfab/sdks/postman/index.md)
- [Início rápido de NodeJS](/pt-BR/services/playfab/sdks/nodejs/quickstart.md)
- [Início rápido de notificações por push](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart.md)
- [Início rápido de matchmaking](/pt-BR/services/playfab/multiplayer/matchmaking/quickstart.md)