Configuration de Developer Console et Postman

Dernière mise à jour : 2023-06-23
  • Rubriques :
  • API
    Afficher plus sur ce sujet
  • Créé pour :
  • Beginner
    Intermediate
    Developer

Dans cette leçon, vous allez configurer un projet dans la console Adobe Developer et le télécharger. Postman collections afin que vous puissiez commencer à utiliser les API de Platform.

Pour terminer les exercices d’API dans ce tutoriel, téléchargez l’application Postman pour votre système d’exploitation. Bien que cela ne soit pas nécessaire pour utiliser les API Experience Platform, Postman facilite les processus d’API et Adobe Experience Platform fournit des dizaines de collections Postman pour vous aider à exécuter des appels API et à découvrir comment ils fonctionnent. Le reste de ce tutoriel suppose des connaissances pratiques de Postman. Pour obtenir de l’aide, reportez-vous à la section Documentation Postman.

Platform est une API d’abord créée. Bien que des options d’interface existent également pour toutes les tâches principales, vous pouvez utiliser l’API Platform à un moment donné. Par exemple, pour ingérer des données, déplacez des éléments entre des environnements de test, automatisez les tâches de routine ou utilisez de nouvelles fonctionnalités de Platform avant la création de l’interface utilisateur.

Architectes de données et Ingénieurs de données Vous devrez peut-être utiliser l’API Platform en dehors de ce tutoriel.

Autorisations requises

Dans le Configuration des autorisations leçon, vous configurez tous les contrôles d’accès requis pour terminer cette leçon.

Configuration de la console Adobe Developer

La console Adobe Developer est la destination des développeurs pour accéder aux API et SDK d’Adobe, écouter des événements en temps quasi réel, exécuter des fonctions sur Runtime ou créer des modules externes ou des applications App Builder. Vous l’utiliserez pour accéder à l’API Experience Platform. Pour plus d’informations, voir Documentation de la console Adobe Developer

  1. Créez un dossier sur votre ordinateur local nommé Luma Tutorial Assets pour les fichiers utilisés dans le tutoriel.

  2. Ouvrez le Console Adobe Developer

  3. Connectez-vous et vérifiez que vous vous trouvez dans l’organisation appropriée.

  4. Sélectionner Créer un projet in Démarrage rapide .

    Créer un projet

  5. Dans le projet nouvellement créé, sélectionnez la Modifier le projet button

  6. Modifiez la variable Titre du projet to Luma Tutorial API Project (ajoutez votre nom à la fin, si plusieurs personnes de votre société suivent ce tutoriel)

  7. Sélectionnez Enregistrer

    Configuration de l’API de projet de la console Adobe Developer

  8. Sélectionner Ajout d’une API

    Configuration de l’API de projet de la console Adobe Developer

  9. Filtrez la liste en sélectionnant Adobe Experience Platform

  10. Dans la liste des API disponibles, sélectionnez API Experience Platform et sélectionnez Suivant.

    Configuration de l’API de projet de la console Adobe Developer

  11. Sélectionner OAuth serveur à serveur comme informations d’identification et sélectionnez Suivant.
    Sélectionnez OAuth Server-to-Server

  12. Sélectionnez la AEP-Default-All-Users profil de produit et sélectionnez Enregistrer l’API configurée

    Sélectionner le profil de produit

  13. Votre projet Developer Console a maintenant été créé.

  14. Dans le Essayez-le de la page, sélectionnez Téléchargement pour Postman puis sélectionnez OAuth serveur à serveur pour télécharger le Postman fichier json d’environnement. Enregistrez le oauth_server_to_server.postman_environment.json dans votre Luma Tutorial Assets dossier.

    Configuration de l’API de projet de la console Adobe Developer

Demander à un administrateur système d’ajouter les informations d’identification de l’API au rôle

Pour utiliser les informations d’identification de l’API pour interagir avec l’Experience Platform, un administrateur système doit affecter les informations d’identification de l’API au rôle créé dans la leçon précédente. Si vous n’êtes pas administrateur système, envoyez-les :

  1. Le Nom de vos informations d’identification d’API (Credential in Luma Tutorial API Project)

  2. Le Adresse électronique du compte technique de vos informations d’identification (cela aidera l’administrateur système à trouver les informations d’identification).

    Nom et Adresse électronique du compte technique de vos informations d’identification

Voici les instructions pour l’administrateur système :

  1. Se connecter Adobe Experience Platform

  2. Sélectionner Autorisations dans le volet de navigation de gauche qui vous mènera au Rôles écran

  3. Ouvrez le Luma Tutorial Platform rôle
    Ouvrir le rôle

  4. Sélectionnez la Informations d’identification de l’API tab

  5. Sélectionner Ajout des informations d’identification API
    Ajouter des informations d’identification

  6. Recherchez le Credential in Luma Tutorial API Project informations d’identification, filtrage à l’aide de la variable Adresse électronique du compte technique fourni par le participant au tutoriel, si la liste est longue

  7. Sélection des informations d’identification

  8. Sélectionnez Enregistrer

    Ajouter des informations d’identification

Configuration de Postman

ATTENTION

L’interface de Postman est régulièrement mise à jour. Les captures d’écran de ce tutoriel ont été effectuées avec Postman v10.15.1 pour Mac, mais les options de l’interface ont peut-être changé.

  1. Télécharger et installer Postman

  2. Ouvrir Postman et créer un espace de travail
    Environnement d’import

  3. Importez le fichier d’environnement json téléchargé, oauth_server_to_server.postman_environment.json
    Environnement d’import

  4. Dans Postman, sélectionnez votre environnement dans la liste déroulante

  5. Sélectionnez l'icône pour afficher les variables d'environnement :

    Changement d’environnement

Ajout du nom de l’environnement de test et de l’identifiant du client

Le SANDBOX_NAME et TENANT_ID et CONTAINER_ID ne sont pas incluses dans l’exportation vers la console Adobe Developer. Nous les ajoutons donc manuellement :

  1. Dans Postman, ouvrez le Variables d’environnement

  2. Sélectionnez la Modifier lien vers la droite du nom de l'environnement

  3. Dans le Ajouter un nouveau champ de variable, saisissez SANDBOX_NAME

  4. Dans les deux champs de valeur, saisissez luma-tutorial, le nom que nous avons donné à notre environnement de test dans la leçon précédente. Si vous avez utilisé un nom différent pour votre environnement de test, par exemple luma-tutorial-ignatiusjreilly, veillez à utiliser cette valeur.

  5. Dans le Ajouter un nouveau champ de variable, saisissez TENANT_ID

  6. Passez à votre navigateur web et recherchez l’ID de tenant de votre société en accédant à l’interface de l’Experience Platform et en extrayant la partie de l’URL. après le signe @. Par exemple, mon identifiant de tenant est techmarketingdemos mais la vôtre est différente :

    Obtention de l’identifiant du client à partir de l’URL de l’interface de Platform

  7. Copiez cette valeur et revenez à la variable Postman Écran Gestion des environnements

  8. Collez votre identifiant de client dans les deux champs de valeur

  9. Dans le Ajouter un nouveau champ de variable, saisissez CONTAINER_ID

  10. Entrée global dans les deux champs de valeur

    REMARQUE

    CONTAINER_ID est un champ dont la valeur est modifiée plusieurs fois au cours du tutoriel. When global est utilisée, l’API interagit avec les éléments fournis par Adobe dans votre compte Platform. When tenant est utilisée, l’API interagit avec vos propres éléments personnalisés.

  11. Sélectionnez Enregistrer

    Champs SANDBOX_NAME, TENANT_ID et CONTAINER_ID ajoutés en tant que variables d’environnement

Lancer des appels API

Récupération d’un jeton d’accès

Adobe fournit un riche ensemble de Postman collections pour vous aider à explorer l’API d’Experience Platform. Ces collections se trouvent dans la variable Adobe Experience Platform Postman Exemples de référentiel GitHub. Vous devez marquer ce référentiel comme vous l’utiliserez de nombreuses fois tout au long de ce tutoriel et plus tard lorsque vous implémenterez Experience Platform pour votre propre société.

La première collection fonctionne avec les API Adobe Identity Management Service (IMS). Il s’agit d’un moyen pratique de récupérer un jeton d’accès dans Postman.

Pour générer le jeton d’accès :

  1. Téléchargez la Collection des API du service Identity Management à Luma Tutorial Assets folder

  2. Importez la collection dans Postman

  3. Sélectionner la requête oAuth : Demander le jeton d’accès request et select Envoyer

  4. Vous devriez avoir une 200 OK réponse avec un jeton d’accès dans la réponse

    Demander les jetons

  5. Le jeton d’accès doit être automatiquement stocké en tant que ACCESS_TOKEN de votre variable d’environnement Postman environnement.

    Postman

Interaction avec une API Platform

Maintenant, lançons un appel API Platform pour confirmer que nous avons tout correctement configuré.

Ouvrez le Experience Platform Postman collections dans GitHub. Cette page contient de nombreuses collections, pour diverses API Platform. Je recommande vivement de le mettre en signet.

Faisons maintenant notre premier appel API :

  1. Téléchargez la Collecte de l’API Schema Registry à Luma Tutorial Assets folder
  2. Importez-le dans Postman
  3. Ouvrir API Schema Registry > Schémas > Schémas de liste
  4. Consultez la Paramètres et En-têtes et notez comment ils incluent certaines des variables d’environnement que nous avons saisies précédemment.
  5. Notez que la variable En-têtes > Champ de valeur Accepter est défini sur application/vnd.adobe.xed-id+json. Les API Schema Registry nécessitent l’une de ces valeurs d’en-tête Accept spécifiées qui fournissent différents formats dans la réponse.
  6. Sélectionner Envoyer pour effectuer votre premier appel API Platform !

Espérons que vous avez réussi 200 OK réponse contenant une liste des schémas XDM fournis par l’Adobe dans votre environnement de test, comme illustré ci-dessous.

Premier appel API dans Postman

Si votre appel n’a pas réussi, prenez quelques instants pour déboguer à l’aide des détails de réponse d’erreur de l’appel API et passez en revue les étapes ci-dessus. Si vous êtes bloqué, veuillez demander de l’aide dans la variable Forum de la communauté ou utilisez le lien situé dans la partie droite de cette page pour "Signaler un problème".

Avec vos autorisations Platform, sandbox et Postman configuré, vous êtes prêt à données de modèle dans les schémas!

Sur cette page