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 la configuration effectuée, chaque fois qu’une valeur arrive à expiration (par exemple, une valeur ACCESS_TOKEN) vous pouvez mettre à jour la valeur actuelle dans l’environnement ; cette nouvelle valeur est utilisée dans toutes vos collections.

Collections Postman

Vous trouverez un dossier contenant toutes les collections Postman disponibles en vous rendant sur la page Experience Platform Postman Exemples de référentiel GitHub. Vous pouvez également trouver un lien de collection Postman dans chaque fichier de sélecteur individuel de la variable Documentation de référence sur les API sur l’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 et sélectionnez Save as pour enregistrer le fichier vers une destination locale de votre choix.

JSON brut

Importation d’une collection Postman

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

gestion du sélecteur d’environnement

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

bouton d'import

Vous êtes invité à choisir un fichier à importer. Sélectionnez le fichier de collection Postman que vous souhaitez 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 des paires clé-valeur différentes qui peuvent être requises pour effectuer une opération CRUD réussie. Veuillez consulter la section Guide de développement d’API pour en savoir plus sur les valeurs requises, des conseils et des exemples.

Pour en savoir plus sur l’interface utilisateur de Postman et ses fonctionnalités disponibles, rendez-vous sur la page Documentation Postman.

Génération d’un jeton d’accès avec Postman pour une utilisation hors production

AVERTISSEMENT

Comme indiqué dans la collection Postman de génération de jetons d’accès Adobe I/O, les méthodes de génération signalées sont adaptées à 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 personne.

La vidéo ci-dessous utilise le Collecte de génération de jeton d’accès Adobe I/O qui peut être téléchargé à 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, rendez-vous sur la page Guide de prise en main de Platform pour plus d’informations sur les en-têtes, les exemples et une liste Guides d’API disponible pour chaque service Platform.

Sur cette page