Skip to main content
Join the Agentforce Hackathon on Nov. 18-19 to compete for a $20,000 Grand Prize. Sign up now. Terms apply.

Configuration et connexion de Postman

Remarque

Remarque

Vous souhaitez apprendre en français ? Commencez le défi dans un Trailhead Playground en français et utilisez les traductions fournies entre crochets pour naviguer. Copiez et collez uniquement les valeurs en anglais, car les validations de défi reposent sur les données en anglais. Si vous ne réussissez pas le défi dans votre organisation en français, nous vous recommandons (1) de définir le paramètre régional sur les États-Unis, (2) de définir la langue sur l’anglais en suivant les instructions ici, puis (3) de cliquer à nouveau sur le bouton « Vérifier le défi ».

Consultez le badge Trailhead dans votre langue pour découvrir comment profiter de l’expérience Trailhead traduite.

Inscription à Postman et création d’un espace de travail

Postman propose une application de bureau et une application de navigateur Web. Pour ce projet, vous allez utiliser l’application de navigateur Web.

  1. Connectez-vous à votre compte Postman ou inscrivez-vous pour créer un compte.
  2. Sélectionnez le menu Workspaces (Espaces de travail).
  3. Sélectionnez Create Workspace (Créer un espace de travail).
  4. Nommez votre espace de travail SalesforceCollection.
  5. Choisissez Personal (Personnel) pour la visibilité.
  6. Cliquez sur Create Workspace (Créer un espace de travail).

Duplication (fork) de la collection Salesforce

  1. Ouvrez l’espace de travail public Salesforce Developers pour dupliquer (fork) la collection d’API Salesforce.
  2. Dans Collections, sélectionnez l’option Salesforce Platform APIs (API Salesforce Platform) pour la développer.
  3. Cliquez sur Create Fork (Dupliquer) pour dupliquer la collection.
  4. Saisissez MySalesforceAPIFork (MonDoubleAPISalesforce).
  5. Conservez SalesforceCollection comme espace de travail.
  6. Cliquez sur Fork Collection (Dupliquer la collection).

La collection est désormais prête dans Postman. Elle va nous servir à autoriser votre organisation et à la tester.

Autorisation de votre organisation

Vous devez vous authentifier auprès de Salesforce pour accéder aux API. L’authentification vous octroie un jeton d’accès valable pour une durée limitée. Répétez ce processus chaque fois que votre jeton d’accès expire.

  1. Assurez-vous que vous êtes connecté à un seul Trailhead Playground dans votre navigateur.
  2. Dans Postman, sous Collections, l’option Salesforce Platform APIs (API Salesforce Platform) doit être sélectionnée.
  3. Veillez à ce que l’option No Environment (Aucun environnement) soit sélectionnée.
  4. L’onglet Authorization (Autorisation) doit être ouvert.
  5. Le type doit correspondre à OAuth 2.0.
  6. Cliquez sur Get New Access Token (Obtenir un nouveau jeton d’accès).
Remarque

Si vous n’êtes pas connecté à un Trailhead Playground ou à une organisation Salesforce, l’écran de connexion Salesforce apparaît dans un nouvel onglet du navigateur. Saisissez le nom d’utilisateur et le mot de passe que vous avez enregistrés à l’étape 1 pour vous connecter.

  1. Cliquez sur Allow (Autoriser) pour autoriser la collection d’API Salesforce Platform pour Postman à accéder à votre Trailhead Playground.
    Dans la boîte de dialogue Allow Access? (Autoriser l’accès ?), cliquez sur Allow (Autoriser) pour autoriser la collection d’API Salesforce pour Postman à accéder à vos informations de base, ainsi qu’à accéder à vos données et à les gérer, ou cliquez sur Deny (Refuser). Vous pouvez révoquer à tout moment en accédant à vos paramètres personnels.
  2. Un message indiquant que l’opération a été effectuée apparaît brièvement. Vous êtes ensuite redirigé vers la boîte de dialogue Manage Access Tokens (Gérer les jetons d’accès).
    Elle affiche le nom du jeton, le jeton d’accès, le type de jeton, l’URL de l’instance, l’horodatage de la signature, la signature et la portée.
  3. Vérifiez que instance_url pointe vers votre Trailhead Playground.
  4. Copiez la valeur d’instance_url afin de l’utiliser à l’étape 12. Veillez à copier uniquement l’URL sans caractères supplémentaires.
  5. Cliquez sur Use Token (Utiliser le jeton).
  6. Ouvrez l’onglet Variables.
  7. Sur la ligne _endpoint, dans la colonne CURRENT VALUE, collez la valeur d’instance_url copiée à l’étape 9.
  8. Cliquez sur Save (Enregistrer).

Test de connexion rapide

Nous allons vérifier que la connexion fonctionne.

  1. Dans Collections, sélectionnez l’option Salesforce Platform APIs (API Salesforce Platform) pour la développer.
  2. Sélectionnez l’option REST pour la développer.
  3. Sélectionnez GET Limits (Limites GET).
    Les limites s’ouvrent dans le panneau principal.
  4. Cliquez sur Send (Envoyer).
    Onglet GET Limits (Limites GET) dans Postman avec le corps de la réponse affiché dans le panneau principal. Le statut indique 200 OK.
  5. Vérifiez que le statut est 200 OK.
    Vous devrez peut-être ACTIVER la configuration Follow Authorization header (Suivre l’en-tête d’autorisation) pour conserver l’en-tête d’autorisation en cas de redirection vers un autre nom d’hôte.
    Paramètre Follow Authorization header (Suivre l’en-tête d’autorisation) sous Get Request Settings (Obtenir les paramètres de demande)

Vous vous êtes authentifié auprès de Salesforce. Vous pouvez désormais utiliser d’autres demandes de la collection.

Publication d’un compte

Vous venez d’extraire des données de l’organisation. À présent, vous allez ajouter de nouvelles données à l’organisation.

  1. Sous REST, sélectionnez SObject, puis POST SObject Create (Créer SObject avec POST).
  2. Ouvrez l’onglet Params (Paramètres).
  3. Sous Path Variables (Variables de chemin), sur la ligne SOBJECT_API_NAME et dans la colonne VALUE, saisissez Account (Compte).
  4. Ouvrez l’onglet Body (Corps).
  5. Remplacez le corps de texte par le code suivant :
    {
  "Name": "Postman",
  "BillingState": "CA"
}
  6. Cliquez sur Save (Enregistrer).
  7. Cliquez sur Send (Envoyer).
    Postman renvoie l’identifiant du nouveau compte.
    Postman avec SObject Create (Créer SObject) dans le panneau principal montrant les résultats Body (Corps) et Send (Envoyer) remplacés. Le statut indique 201 Created (201 Créé).
  8. Vérifiez que le statut est 201 Created (201 Créé).
Remarque

Si vous n’obtenez pas le statut 201 Created (201 Créé), vous êtes peut-être connecté à une autre organisation. Vérifiez que la variable instance_url est définie sur votre Trailhead Playground.

  1. Ouvrez le Playground autorisé.
  2. Depuis App Launcher (Lanceur d’application) (“”), recherchez et ouvrez Accounts (Comptes).
  3. Vérifiez l’existence du nouveau compte.

Excellent ! Vous avez configuré Postman de sorte qu’il interagisse avec votre organisation. La collection d’API Salesforce pour Postman que vous avez chargée vous permettra de découvrir les API Salesforce.

Ressources

Partagez vos commentaires sur Trailhead dans l'aide Salesforce.

Nous aimerions connaître votre expérience avec Trailhead. Vous pouvez désormais accéder au nouveau formulaire de commentaires à tout moment depuis le site d'aide Salesforce.

En savoir plus Continuer à partager vos commentaires