Guide de l’API Query Service

Ce guide de développement décrit les étapes à suivre pour effectuer diverses opérations dans Adobe Experience Platform Query Service API.

Prise en main

Ce guide nécessite une compréhension pratique des divers services Adobe Experience Platform impliqués dans l’utilisation de la Query Service.

  • Query Service: Permet d’interroger des jeux de données et de capturer les requêtes résultantes sous forme de nouveaux jeux de données dans Experience Platform.
  • Experience Data Model (XDM) System : cadre normalisé selon lequel Experience Platform organise les données de l’expérience client.
  • Sandboxes : Experience Platform fournit des sandbox virtuelles qui divisent une instance Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience numérique.

Les sections suivantes apportent des informations supplémentaires dont vous aurez besoin pour utiliser correctement Query Service à l’aide de l’API.

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 cette documentation pour les exemples d’appels API, consultez la section sur lecture d’exemples d’appels API dans le Experience Platform guide de dépannage.

Collecte des valeurs des en-têtes requis

Pour lancer des appels aux API Experience Platform, vous devez d’abord suivre le tutoriel d’authentification. Le tutoriel d’authentification fournit les valeurs de chacun des en-têtes requis dans tous les appels d’API Platform, comme indiqué ci-dessous :

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

Dans Experience Platform, toutes les ressources sont isolées dans des environnements de test virtuels spécifiques. Toutes les requêtes envoyées à Platform Les API requièrent un en-tête qui spécifie le nom de l’environnement de test dans lequel l’opération aura lieu :

  • x-sandbox-name : {SANDBOX_NAME}
REMARQUE

Pour plus d’informations sur l’utilisation des environnements de test dans Experience Platform, reportez-vous à la section documentation sur les environnements de test.

Exemples d’appels API

Maintenant que vous comprenez les en-têtes à utiliser, vous êtes prêt à commencer à lancer des appels au Query Service API. Les documents suivants passent en revue les différents appels API que vous pouvez effectuer à l’aide de la variable Query Service API. Chaque appel d’exemple inclut le format général de l’API, un exemple de requête présentant les en-têtes requis et un exemple de réponse.

Étapes suivantes

Maintenant que vous avez appris à lancer des appels à l’aide de la variable Query Service API, vous pouvez créer vos propres requêtes non interactives. Pour plus d’informations sur la création de requêtes, veuillez lire le guide de référence SQL.

Sur cette page