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 Experience Platform possèdent des collections Postman qui peuvent être utilisées pour faciliter l’émission d’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 vers les différentes collections fournies ci-dessous. Une fois configurée, chaque fois qu’une valeur expire (par exemple, une 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 consultant le référentiel GitHub d’exemples Experience Platform Postman. Vous pouvez également trouver un lien de collection Postman dans chaque fichier Swagger individuel dans la documentation de référence de l’API sur Adobe I/O.

Pour télécharger une collection Postman, sélectionnez Raw dans la page GitHub pour charger le fichier JSON brut dans un nouvel onglet. Cliquez ensuite avec le bouton droit et sélectionnez Save as pour enregistrer le fichier vers une destination locale de votre choix.

JSON brut

Importer une collection Postman import

Pour utiliser une collection Postman, vous devez avoir configuré un environnement. Une fois la configuration de l’environnement terminée, sélectionnez le sélecteur de Manage Environments dans le coin supérieur droit.

gérer le sélecteur d’environnement

Une fenêtre contextuelle s’affiche et affiche tous vos environnements actuels. Pour importer une collection, sélectionnez import .

bouton importer

Vous êtes invité à 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 .

collection renseignée

Chaque collection comporte différentes paires clé-valeur qui peuvent être nécessaires pour effectuer une opération CRUD réussie. Veuillez consulter le guide du développement de l’API du service pour en savoir plus sur les valeurs requises, obtenir 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érer un jeton d’accès avec Postman pour une utilisation hors production

WARNING
Comme indiqué dans la collection Postman du service Identity Management (IMS), les méthodes de génération mentionnées sont adaptées à une utilisation hors production. La signature locale charge une bibliothèque JavaScript à partir d’un hôte tiers et la signature à distance envoie la clé privée à un service web détenu et exploité par Adobe. Bien qu’Adobe ne stocke pas cette clé privée, les clés de production ne doivent jamais être partagées avec qui que ce soit.

La vidéo ci-dessous utilise la collection Postman d’Identity Management Service (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 d’Experience Platform pour plus d’informations sur les en-têtes requis, des exemples et une liste de guides d’API disponibles pour chaque service Experience Platform.

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5