[Version Beta]{class="badge informative"}

Prise en main des sources en libre-service (SDK de diffusion en continu)

NOTE
Le SDK de diffusion en continu des sources en libre-service est en version bêta. Veuillez lire la présentation des sources pour plus d’informations sur l’utilisation de sources étiquetées bêta.

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

Aperçu général de la configuration

Le processus étape par étape de configuration de votre source dans Experience Platform est décrit ci-dessous :

Intégration

Documentation

Vous pouvez également télécharger les modèles de documentation ci-dessous :

Conditions préalables

IMPORTANT
Pour envoyer des mises à jour, la source intégrée à Experience Platform doit pouvoir prendre en charge un webhook auquel un point de terminaison peut être abonné.

Pour utiliser des sources en libre-service (SDK de diffusion en continu), vous devez vous assurer que vous avez accès à une organisation d’environnement de test 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

Les sources en libre-service (SDK de diffusion en continu) et Flow Service La documentation des API 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és 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, voir documentation des 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 de diffusion en continu), consultez le tutoriel sur création d’une source.

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