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
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.
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.
- Cliquez sur l'onglet Get Your Login Credentials (Obtenir vos identifiants de connexion) et notez votre nom d’utilisateur.
- Cliquez sur Reset My Password (Réinitialiser mon mot de passe).
Cela envoie un e-mail à l’adresse associée à votre nom d’utilisateur.
- Cliquez sur le lien dans l’e-mail.
- 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.
- Dans votre Trailhead Playground, sous Setup (Configuration), saisissez
cors
dans la zone de recherche rapide et sélectionnez CORS.
- Dans la liste des origines autorisées, cliquez sur New (Nouveau).
- Saisissez
https://*.postman.com
comme modèle d’URL d’origine.
- Cliquez sur Save (Enregistrer).
- Sélectionnez de nouveau CORS.
- Cliquez sur New (Nouveau) et saisissez
https://*.postman.co
(notez l’extension de domaine .co) comme modèle d’URL d’origine.
- 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