Configuration de votre organisation

Objectifs d’apprentissage

Dans ce projet, vous apprendrez à :

• Préparer votre organisation à utiliser Postman
  
• Charger la collection d’API Salesforce Platform pour Postman
  
• Connecter Postman à votre organisation
  
• Vérifier la connexion à Postman
  

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.

Pourquoi utiliser Postman pour accéder aux API Salesforce Platform ?

Salesforce propose un riche ensemble d’interfaces de programmation d’application (API) s’intégrant à des systèmes tiers. Toutes ces API sont minutieusement documentées. Néanmoins, comment les essayer rapidement sur une organisation donnée, ou mieux encore, sur plusieurs organisations ? Postman vous permet de découvrir, d’explorer et de tester les options d’intégration avec les API Salesforce Platform.

À propos des API Salesforce Platform

Salesforce fournit un accès programmatique aux informations de votre organisation via des API simples, efficaces et sécurisées. Les API fournies par Salesforce incluent REST, SOAP, Connect (Connexion), User Interface (Interface utilisateur), Analytics (Analyse), Bulk (Transfert en masse), Metadata (Métadonnées) et Streaming (Flux).

À propos de Postman

Postman est une application qui vous permet de configurer et d’appeler des API HTTP, telles que REST ou SOAP. Vous configurez cet outil performant dans une interface utilisateur graphique facile à utiliser. Il prend en charge les variables d’environnement, les espaces de travail d’équipe et l’automatisation JavaScript. Si vous ne connaissez pas Postman, consultez le Centre d’apprentissage.

Application de bureau ou de navigateur Web ?

Postman est disponible comme application de bureau ou dans un navigateur Web. Dans ce projet, vous allez configurer et utiliser Postman dans un navigateur Web, car cela ne nécessite pas de téléchargement ni d’installation de logiciel.

À propos de la collection d’API Salesforce Platform pour Postman

La collection d’API Salesforce Platform pour Postman est une ressource qui regroupe plus de 200 modèles de demande pour de nombreuses API Salesforce Platform. Cette collection open source utilise l’environnement et les variables configurables Postman afin que vous puissiez facilement vous authentifier et tester les demandes sur plusieurs organisations Salesforce.

Création d’un Trailhead Playground

Pour ce projet, vous devez créer un Trailhead Playground. Faites défiler cette page jusqu’en bas, cliquez sur le nom du playground, puis cliquez sur Create Playground (Créer un playground). Il faut généralement 3 à 4 minutes pour créer un Trailhead Playground.

oui, nous parlons bien d’un tout nouveau Trailhead Playground ! Si vous utilisez une organisation ou un Playground existant, vous pourriez avoir des problèmes pour réaliser le projet.

Obtention de votre nom d’utilisateur et votre mot de passe Trailhead Playground

Commençons par ouvrir votre Trailhead Playground. Faites défiler l’écran jusqu’au bas de cette page et cliquez sur Launch (Lancer). Si vous voyez un onglet intitulé Obtenir vos identifiants de connexion dans votre organisation, c’est parfait ! Passez à l’étape 1. Sinon, depuis le lanceur d’application (), recherchez et ouvrez Playground Starter et laissez-vous guider.

1. Cliquez sur l'onglet Get Your Login Credentials (Obtenir vos identifiants de connexion) et notez votre nom d’utilisateur.
   
2. Cliquez sur Reset My Password (Réinitialiser mon mot de passe).
   Cela envoie un e-mail à l’adresse associée à votre nom d’utilisateur.
   
3. Cliquez sur le lien dans l’e-mail.
   
4. Saisissez un nouveau mot de passe, confirmez-le, puis cliquez sur Change Password (Modifier le mot de passe).
   

Enregistrez votre nom d’utilisateur et votre mot de passe pour une utilisation ultérieure dans ce projet.

Configuration du partage de ressources inter-origines dans Salesforce

Le partage de ressources inter-origines (CORS) permet au code exécuté dans un navigateur Web de communiquer avec Salesforce à partir d’une origine spécifique. Nous allons ajouter des modèles d’URL pour Postman.

1. Dans votre Trailhead Playground, sous Setup (Configuration), saisissez cors dans la zone de recherche rapide et sélectionnez CORS.
   
2. Dans la liste des origines autorisées, cliquez sur New (Nouveau).
   
3. Saisissez https://*.postman.com comme modèle d’URL d’origine.
   
4. Cliquez sur Save (Enregistrer).
   
5. Sélectionnez de nouveau CORS.
   
6. Cliquez sur New (Nouveau) et saisissez https://*.postman.co (notez l’extension de domaine .co) comme modèle d’URL d’origine.
   
7. Cliquez sur Save (Enregistrer).
   

Vous pouvez désormais connecter Postman à votre Playground. C’est précisément ce que vous allez faire dans l’étape suivante.

Ressources

• Site externe : Centre d’apprentissage Postman
• GitHub : API Salesforce pour Postman
• GitHub : Installation avec l’interface utilisateur Web Postman
• YouTube : Utilisation de la collection d’API Salesforce avec l’interface utilisateur Web Postman | Récapitulatifs pour développeur
• Aide Salesforce : Quelle API utiliser ?
• Trailhead : Client API Postman