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

# Démarrage rapide de la collection d'API REST PlayFab pour Postman

> Importez la collection d'API REST PlayFab dans Postman, obtenez un jeton d'entité et effectuez votre premier appel d'API PlayFab pour gérer les titres et les entités.

# Démarrage rapide : collection d'API REST PlayFab pour Postman

Prenez en main la collection d'API REST PlayFab pour Postman. Suivez les étapes pour installer le package et essayer l'exemple de code pour les tâches de base. PlayFab est une plateforme back-end complète pour les jeux en ligne. Utilisez la collection d'API REST PlayFab pour Postman afin de :

* Obtenir un jeton d'entité
* Ajouter, modifier ou supprimer des entités dans un titre
* Configurer le contenu d'un titre

[Documentation de référence de l'API](/fr-CA/services/playfab/api-references) | [Dépôt GitHub de la collection Postman PlayFab](https://github.com/PlayFab/PostmanCollection)

## Prérequis

* Un [compte de développeur PlayFab](https://developer.playfab.com)
* L'[application native Postman](https://www.getpostman.com/)
* Un système d'exploitation exécutant [TLS](https://learn.microsoft.com/en-us/windows/win32/secauthn/transport-layer-security-protocol) 1.2 ou version ultérieure ([prise en charge de TLS 1.2 par Windows](https://learn.microsoft.com/en-us/dotnet/framework/network-programming/tls#support-for-tls-12))

### Ajout des collections PlayFab

* Créez un espace de travail

  > \[!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 - Sélectionner 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 - Créer un espace de travail" width="895" height="664" data-path="images/playfab/sdks/postman/tutorials/postman-new-create-workspace2.png" />

* Sélectionnez **Import** *(en haut à gauche de la fenêtre)*

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

* Sélectionnez **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 - Sélectionner l'importation depuis un lien" 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 - Importer depuis un lien" width="963" height="406" data-path="images/playfab/sdks/postman/tutorials/postman-new-import-from-link2.png" />

* Collez le lien suivant dans la zone de texte URL, puis sélectionnez **Continue** et **Import**

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

  * Si vous essayez de télécharger le SDK bêta, accédez au fichier playfabV2.json dans le [dépôt GitHub Postman bêta](https://github.com/PlayFab/PostmanCollection/blob/master/playfabV2.json)
  * Sélectionnez **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 - Afficher le JSON bêta brut" width="2058" height="822" data-path="images/playfab/sdks/postman/tutorials/postman-new-view-raw-beta.png" />
  * Copiez l'URL depuis le navigateur, collez le lien dans la zone de texte URL, puis sélectionnez **Continue** et **Import**

* Le SDK Postman PlayFab devrait maintenant apparaître sous l'onglet Collections *(en haut à gauche de la fenêtre)*

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

### Ajout de variables d'environnement

* Sélectionnez **Environments** puis **Create Environment** pour créer un nouvel environnement

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

* Nommez votre environnement; nous recommandons « \[titleId] - Test Environment »

<Note>
  Vous pouvez trouver votre ID de titre en vous connectant à [Game Manager](https://developer.playfab.com/en-us/my-games) et en copiant la valeur hexadécimale située sous le nom de votre titre sur la page principale **My Studios and Titles**.
</Note>

* Ajoutez les 3 variables suivantes à l'environnement :

  | Variable | Valeur initiale | Valeur actuelle |
  | - | - | - |
  | TitleId | \[titleId] | \[titleId] |
  | SecretKey | \[secretKey] | \[secretKey] |
  | EntityToken | | |

<Note>
  Pour en savoir plus sur les clés secrètes de titre et sur l'endroit où les trouver, consultez la documentation [Gestion des clés secrètes](/fr-CA/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 - Créer un environnement" width="1294" height="719" data-path="images/playfab/sdks/postman/tutorials/postman-new-create-environment.png" />

* Une fois terminé, sélectionnez **Save** pour enregistrer votre nouvel environnement
* Sélectionnez la liste déroulante des environnements pour basculer vers votre nouvel environnement *(en haut à droite de la fenêtre)*

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

### Obtention d'un jeton d'entité de titre

L'une des façons d'interagir avec le [modèle de programmation d'entités](/fr-CA/services/playfab/live-service-management/game-configuration/entities) de PlayFab consiste à obtenir un jeton d'entité de titre. Cela peut être utile si vous souhaitez modifier les données de configuration du titre ou apporter des ajustements à un grand nombre de joueurs :

* Dans le dossier **PlayFab Collections**, développez l'espace de noms **Authentication** et sélectionnez `GetEntityToken`
* Sous **Headers**, décochez `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 - En-tête Get Entity Token" width="850" height="471" data-path="images/playfab/sdks/postman/tutorials/postman-new-get-entity-token-header.png" />
* Sélectionnez **Send**
* Affectez le jeton d'entité renvoyé à votre variable d'environnement `EntityToken`
  * Dans la réponse, mettez en surbrillance la chaîne `EntityToken`
  * Cliquez avec le bouton droit et sélectionnez **Set: \[Environment]** pour votre nouvel environnement
  * Sélectionnez **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 - Définir la variable EntityToken" width="1294" height="594" data-path="images/playfab/sdks/postman/tutorials/postman-new-set-entity-token-variable.png" />

<Note>
  Les jetons d'entité expirent au bout de **24 heures**. Vous devez ensuite réexécuter `GetEntityToken` pour obtenir un nouveau jeton d'entité et mettre à jour votre variable d'environnement
</Note>

### Obtention d'un jeton d'entité Title\_Player\_Account

Une autre façon d'interagir avec le [modèle de programmation d'entités](/fr-CA/services/playfab/live-service-management/game-configuration/entities) de PlayFab consiste à obtenir un jeton d'entité Title\_Player\_Account. Cela est utile si vous souhaitez apporter des modifications à un seul joueur :

* Dans le dossier **PlayFab Collections**, développez l'espace de noms **Client** et sélectionnez `LoginWithCustomID`
* Sous **Body**, remplacez la valeur de `CreateAccount` `false` par `true`
* Sélectionnez **Send**
* Affectez le jeton d'entité renvoyé à votre variable d'environnement `EntityToken`
  * Dans la réponse, mettez en surbrillance la chaîne `EntityToken`
  * Cliquez avec le bouton droit et sélectionnez **Set: \[Environment]** pour votre nouvel environnement
  * Sélectionnez **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 - Obtenir un jeton d'entité Title_Player_Account" width="1298" height="729" data-path="images/playfab/sdks/postman/tutorials/postman-new-get-title_player_account-entity-token.png" />

## Résolution des problèmes

* Non-correspondance entre l'ID de titre et la clé secrète
  * Si vous essayez d'obtenir un jeton d'entité de titre et recevez une erreur `401: Unauthorized`, vérifiez que l'ID de titre et les clés secrètes sont corrects en vous connectant à [Game Manager](https://developer.playfab.com/en-us/my-games)
* Jeton d'entité expiré
  * Si vous avez précédemment obtenu un jeton d'entité et que vos tentatives d'appel d'autres API échouent, votre jeton d'entité a peut-être expiré. Obtenez un autre jeton d'entité, enregistrez-le dans la variable d'environnement `EntityToken`, puis réessayez d'appeler l'API précédente
* Type de jeton d'entité incorrect
  * Il existe différents types d'entités (consultez [Types d'entités intégrés disponibles](/fr-CA/services/playfab/live-service-management/game-configuration/entities/available-built-in-entity-types)). Les différentes API autorisent différents types d'entités; par exemple, vous essayez peut-être d'appeler `GetLanguageList` avec un jeton d'entité title\_player\_account au lieu d'un jeton d'entité de titre
* Environnement incorrect :
  * Vérifiez que vous utilisez le bon environnement en consultant la liste déroulante des environnements *(en haut à droite de la fenêtre)*

## Étapes suivantes

Vous disposez maintenant d'un jeton d'entité à transmettre à d'autres appels d'API pour commencer à configurer votre titre PlayFab.

<Note>
  \[!div class="nextstepaction"] [Démarrages rapides PlayFab >](/fr-CA/services/playfab/live-service-management/gamemanager/quickstart) \[!div class="nextstepaction"] [Références de l'API >](/fr-CA/services/playfab/api-references)
</Note>


## Related topics

- [SDK Postman (REST)](/fr-CA/services/playfab/sdks/postman/index.md)
- [Démarrage rapide NodeJS](/fr-CA/services/playfab/sdks/nodejs/quickstart.md)
- [Démarrage rapide JavaScript pour JavaScript natif et Phaser](/fr-CA/services/playfab/sdks/javascript/quickstart.md)
- [Démarrage rapide des notifications push](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart.md)
- [Démarrage rapide C++ pour Linux](/fr-CA/services/playfab/sdks/playfab-cpp/quickstart-linux.md)