[Version bêta]{class="badge informative"}
Prise en main des sources en libre-service (SDK de diffusion en continu)
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 de lancer des appels à l’ 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
- Pour commencer à documenter votre source, consultez la présentation sur la création de documentation pour les sources en libre-service.
- Lisez le guide sur l’utilisation de l’interface web GitHub pour savoir comment créer de la documentation à l’aide de GitHub.
- Lisez le guide sur l’utilisation d’un éditeur de texte pour savoir comment créer de la documentation à l’aide de votre ordinateur local.
- Utilisez le modèle de documentation de l’API du SDK de diffusion en continu pour documenter votre source dans l’API.
- Utilisez le modèle de documentation de l’interface utilisateur du SDK de diffusion en continu pour documenter votre source dans l’interface utilisateur.
Vous pouvez également télécharger les modèles de documentation ci-dessous :
Conditions préalables
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
La documentation des sources en libre-service (SDK de diffusion en continu) 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}
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 la création d’une source.