Postman dans Adobe Experience Platform
Postman est une plateforme de collaboration pour le développement d’API qui vous permet de configurer des environnements avec des variables prédéfinies, de partager des collections d’API, de rationaliser les requêtes CRUD, etc. La plupart des services d’API Platform disposent de collections Postman qui peuvent être utilisées pour faciliter les appels d’API.
Configuration d’un environnement Postman pour Experience Platform
Le guide vidéo suivant décrit la création et la configuration de votre environnement Postman. Un environnement Postman contient tous les en-têtes requis pour effectuer des appels API aux différentes collections fournies ci-dessous. Une fois configurée, chaque fois qu’une valeur expire (par exemple, ACCESS_TOKEN
), vous pouvez mettre à jour la valeur actuelle dans l’environnement et cette nouvelle valeur est utilisée dans toutes vos collections.
Collections Postman collections
Vous trouverez un dossier contenant toutes les collections Postman disponibles en vous rendant sur le référentiel GitHub d’exemples Postman Experience Platform. Vous pouvez également trouver un lien de collection Postman dans chaque fichier swagger individuel dans la documentation de référence sur l’API sur Adobe I/O.
Pour télécharger une collection Postman, sélectionnez Raw sur la page GitHub pour charger le fichier JSON brut dans un nouvel onglet. Cliquez ensuite avec le bouton droit de la souris et sélectionnez Save as pour enregistrer le fichier vers une destination locale de votre choix.
Importation d’une collection Postman import
Pour utiliser une collection Postman, un environnement doit être configuré. Une fois la configuration de l’environnement terminée, sélectionnez le sélecteur Manage Environments dans le coin supérieur droit.
Une fenêtre contextuelle s’affiche et affiche tous vos environnements actuels. Pour importer une collection, sélectionnez import .
Vous devez choisir un fichier à importer. Sélectionnez le fichier de collection Postman à importer. Une fois sélectionnée, la collection est renseignée dans le rail de gauche sous l’onglet Collections .
Chaque collection comporte des paires clé-valeur différentes qui peuvent être requises pour effectuer une opération CRUD réussie. Consultez le guide de développement de l’API du service pour en savoir plus sur les valeurs requises, des conseils et consulter des exemples.
Pour en savoir plus sur l’interface utilisateur de Postman et ses fonctionnalités disponibles, consultez la documentation de Postman.
Génération d’un jeton d’accès avec Postman pour une utilisation hors production
La vidéo ci-dessous utilise la collection Postman du service Identity Management (IMS) qui peut être téléchargée à partir du référentiel GitHub public.
Étapes suivantes
Ce document présente les environnements Postman, les collections et la manière d’importer des collections. Maintenant que Postman est prêt, consultez le guide de prise en main de Platform pour plus d’informations sur les en-têtes, les exemples requis et une liste de guides de l’API disponibles pour chaque service Platform.