Getting started with Content and Commerce AI

Remarque

Content and Commerce AI est en version bêta. La documentation peut être modifiée.

Content and Commerce AI utilise les API d'E/S d'Adobe. Pour appeler les API d'E/S d'Adobe et l'intégration de la console d'E/S, vous devez d'abord suivre le didacticiel d'authentification.

Cependant, lorsque vous atteignez l’étape de l’API ​Ajoute, l’API se trouve sous Experience Cloud et non pas Adobe Experience Platform, comme illustré dans la capture d’écran suivante :

ajout d’une API de contenu et de commerce

Le didacticiel d'authentification fournit les valeurs de chacun des en-têtes requis dans tous les appels d'API d'E/S d'Adobe, comme indiqué ci-dessous :

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Créer un environnement Postman (facultatif)

Une fois que vous avez configuré votre projet et votre API dans Adobe Developer Console, vous avez la possibilité de télécharger un fichier d'environnement pour Postman. Sous API dans le rail de gauche de votre projet, sélectionnez Contenu et Commerce AI. Un nouvel onglet s’ouvre, contenant une carte intitulée "Try it out". Sélectionnez Télécharger pour Postman pour télécharger un fichier JSON utilisé pour configurer votre environnement postman.

téléchargement pour postman

Après avoir téléchargé le fichier, ouvrez Postman et sélectionnez l'icône d' engrenage dans le coin supérieur droit pour ouvrir la boîte de dialogue gérer les environnements .

icône d'engrenage

Ensuite, sélectionnez Importer dans la boîte de dialogue Gérer les environnements .

import

Vous êtes redirigé et invité à sélectionner un fichier d’environnement sur votre ordinateur. Sélectionnez le fichier JSON que vous avez téléchargé précédemment, puis sélectionnez Ouvrir pour charger l’environnement.

Vous êtes redirigé vers l’onglet Gérer les environnements avec un nouveau nom d’environnement renseigné. Sélectionnez le nom de l'environnement à vue et modifiez les variables disponibles dans Postman. Vous devez quand même renseigner manuellement les champs JWT_TOKEN et ACCESS_TOKEN. Ces valeurs auraient dû être obtenues lors de l’exécution du didacticiel d’authentification.

Une fois les variables terminées, elles doivent ressembler à la capture d’écran ci-dessous. Sélectionnez Mettre à jour pour terminer la configuration de votre environnement.

Vous pouvez désormais sélectionner votre environnement dans le menu déroulant situé dans le coin supérieur droit et renseigner automatiquement toutes les valeurs enregistrées. Il vous suffit de modifier à tout moment les valeurs pour mettre à jour tous vos appels d’API.

example

Pour plus d'informations sur l'utilisation des API d'E/S d'Adobe avec Postman, consultez le post Medium sur l' utilisation de Postman pour l'authentification JWT sur les E/Sd'Adobe.

Lecture d’exemples d’appels API

Ce guide fournit des exemples d’appels API pour démontrer comment formater vos requêtes. Il s’agit notamment de chemins d’accès, d’en-têtes requis et de payloads de requêtes correctement formatés. L’exemple JSON renvoyé dans les réponses de l’API est également fourni. Pour plus d’informations sur les conventions utilisées dans la documentation pour les exemples d’appels API, consultez la section sur la lecture d’exemples d’appels API dans le guide de dépannage d’Experience Platform.

Étapes suivantes

Une fois que vous disposez de toutes vos informations d’identification, vous êtes prêt à configurer un collaborateur personnalisé pour Content and Commerce AI. Les documents suivants aident à comprendre le cadre d'extensibilité et la configuration des environnements.

Pour en savoir plus sur le Cadre d'extensibilité, début en lisant l' introduction au document d'extensibilité . Ce document décrit les conditions préalables et les exigences de mise en service.

Pour en savoir plus sur la configuration d'un environnement pour Content and Commerce AI, consultez le début en lisant le guide de configuration d'un environnementde développement. Ce document fournit des instructions de configuration qui vous permettent de développer pour le service Asset Compute.

Sur cette page