Prise en main des sources en libre-service (SDK par lots)

Les sources en libre-service (SDK par lots) vous permettent d’intégrer votre propre source REST pour importer des données par lots dans Adobe Experience Platform. Ce document présente les concepts de base que vous devez connaître avant de lancer des appels à l’ Flow Service API.

Conditions préalables

Pour utiliser des sources en libre-service (SDK par lots), vous devez vous assurer que vous avez accès à une organisation Sandbox configurée avec des sources Adobe Experience Platform.

Ce guide nécessite également une compréhension pratique des composants suivants de Adobe Experience Platform :

  • Sources : Experience Platform permet d’ingérer des données provenant de diverses sources tout en vous offrant la possibilité de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services de Platform.
  • Sandbox : Experience Platform fournit des sandbox virtuels qui divisent une instance de plateforme unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.

Lecture d’exemples d’appels API

La documentation des sources en libre-service (SDK par lots) et de l’API Flow Service 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.

Collecte des valeurs des en-têtes requis

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

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

Toutes les ressources de Platform, y compris celles appartenant à Flow Service, sont isolées dans des environnements de test virtuels spécifiques. Toutes les requêtes envoyées aux API Platform nécessitent un en-tête spécifiant le nom du sandbox dans lequel l’opération sera effectuée :

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
Pour plus d’informations sur les environnements de test dans Platform, consultez la documentation sur les environnements de test.

Toutes les requêtes contenant un payload (POST, PUT, PATCH) requièrent un en-tête supplémentaire :

  • Content-Type: application/json

Étapes suivantes

Pour commencer à créer une source avec des sources en libre-service (SDK par lots), consultez le tutoriel sur la création d’une source.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089