Paramétrer un environnement Postman

Pour vous faire gagner du temps et vous permettre de démarrer immédiatement, cet article décrit comment configurer et utiliser un environnement Postman pour vos environnements Dataverse sans que vous ayez à enregistrer votre propre application Azure Active Directory (Azure AD). Pour plus d'informations sur l'environnement Postman et les variables, voir Documentation Postman > Variables.

Conditions préalables

• Avoir un environnement Dataverse Power Apps auquel vous pouvez vous connecter.
• Téléchargez et installez l’application de bureau Postman.

Connectez-vous à votre environnement Dataverse

Important

Pour vous faire gagner du temps et vous permettre de démarrer immédiatement, nous avons fourni un ID client pour une application qui est enregistrée pour tous les environnements Dataverse ; vous n'avez donc pas besoin d'enregistrer votre application Azure Active Directory (Azure AD) pour qu'elle se connecte à l'API Dataverse.

1. Lancez l’application de bureau Postman.

2. Pour créer un nouvel environnement, sélectionnez Environnements à gauche et cliquez sur +.

   

3. Entrez un nom pour votre environnement, par exemple : MonNouvelEnvironnement.

4. Connectez-vous à Power Apps pour obtenir l'URL de base du point de terminaison d'API web.

5. Sélectionnez votre environnement Power Apps et cliquez sur le bouton Paramètres dans le coin supérieur droit. Sélectionnez ensuite Ressources du développeur.

   

6. Dans le volet Ressources du développeur, récupérez l'URL de base du point de terminaison d'API web.

   

7. Dans Postman, ajoutez les paires clé-valeur suivantes dans l'espace d'édition et utilisez la valeur initiale pour la valeur actuelle.

   VARIABLE	VALEUR INITIALE	ACTION
   url	https://<your org name>.api.crm.dynamics.com	Utiliser l'URL de base du point de terminaison d'API web
   clientid	51f81489-12ee-4a9e-aaae-a2591f45987d	Copier la valeur
   version	9.2	Copier la valeur
   webapiurl	{{url}}/api/data/v{{version}}/	Copier la valeur
   callback	https://localhost	Copier la valeur
   authurl	https://login.microsoftonline.com/common/oauth2/authorize?resource={{url}}	Copier la valeur

8. Vos paramètres devraient apparaître comme ci-dessous :

   

9. Cliquez sur Enregistrer pour enregistrer votre environnement nouvellement créé, nommé MonNouvelEnvironnement.

Générer un jeton d’accès à utiliser avec votre environnement

Pour vous connecter à l’aide de OAuth 2.0, vous devez disposer d’un jeton d’accès. Suivez les étapes ci-dessous pour obtenir un nouveau jeton d’accès :

1. Assurez-vous que le nouvel environnement que vous avez créé MonNouvelEnvironnement est sélectionné. Cliquez sur + en regard de MonNouvelEnvironnement.

   

2. Le volet suivant s’affiche. Sélectionnez l’onglet Autorisation.

   

3. Définissez le Type sur OAuth 2.0 et définissez Ajouter des données d'autorisation à sur En-têtes de demande.

   

4. Dans le volet Configurer un nouveau jeton, définissez les valeurs suivantes :

   Nom	Valeur	Action
   Type d’autorisation	Implicite	Sélectionner Implicite dans la liste déroulante
   URL de rappel	{{callback}}	Copier la valeur
   URL d'autorisation	{{authurl}}	Copier la valeur
   ID client	{{clientid}}	Copier la valeur

5. Vos paramètres devraient apparaître comme ci-dessous :

   

   Notes

   Si vous configurez des environnements dans Postman pour plusieurs instances Dataverse à l’aide de différentes informations d’identification utilisateur, cliquez sur Effacer les cookies pour supprimer les cookies mis en cache par Postman.

6. Cliquez sur Obtenir un nouveau jeton d’accès.

   Une fois que vous avez cliqué sur Obtenir un nouveau jeton d’accès, une boîte de dialogue de connexion à Azure Active Directory s'affiche. Entrez votre nom d'utilisateur et votre mot de passe, puis cliquez sur Se connecter. Une fois l'authentification terminée, la boîte de dialogue suivante apparaît.

   

7. Après la fermeture automatique du dialogue d'authentification au bout de quelques secondes, le volet Gérer les jetons d'accès s'affiche. Cliquez sur Utiliser le jeton.

   

8. Le jeton nouvellement généré apparaîtra automatiquement dans la zone de texte sous le menu déroulant Jetons disponibles.

   

Tester votre connexion

Ce qui suit montre comment tester votre connexion en utilisant WhoAmI :

1. Sélectionnez GET comme méthode HTTP et ajoutez {{webapiurl}}WhoAmI dans l’espace de modification.

   

2. Cliquez sur Envoyer pour envoyer cette requête.

3. Si votre requête aboutit, vous verrez les données qui reviennent du point de terminaison WhoAmI, comme ci-dessous :

   

Étapes suivantes

Découvrez comment utiliser Postman pour exécuter des opérations avec l’API web.

Documents de service

Voir aussi

Utiliser Postman pour exécuter des opérations
Guide pas-à-pas : Enregistrer une application Dataverse auprès d’Azure Active Directory

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).