Guide de l’API des sources en libre-service (SDK par lots)
Ce document donne un aperçu du processus de création d’une source, y compris des étapes pour écrire et envoyer une nouvelle spécification de connexion à l’aide de l’ Flow Service API.
Flow Service est utilisé pour collecter et centraliser les données client provenant de diverses sources dans Platform. Le service fournit une interface utilisateur et une API RESTful qui vous permettent de configurer facilement des connexions source à différents fournisseurs de données. Ces connexions source vous permettent d’authentifier vos systèmes tiers, de définir des heures d’ingestion et de gérer le débit d’ingestion des données.
L’API Flow Service fournit plusieurs points de terminaison qui vous permettent de gérer par programmation les spécifications de connexion et de flux pour une nouvelle source que vous intégrez par le biais de sources en libre-service (SDK par lots).
Création d’une spécification de connexion
La première étape de la configuration d’une nouvelle source consiste à créer une spécification de connexion.
Les spécifications de connexion renvoient les propriétés du connecteur d’une source. Elles incluent des spécifications d’authentification liées à la création des connexions de base et source, ainsi qu’un identifiant de spécification de connexion fixe affecté à une source particulière. Les spécifications de connexion sont indépendantes du client et de l’organisation. Une spécification de connexion type contient des informations de base sur une source donnée, ainsi que trois sections distinctes : authSpec, sourceSpec et exploreSpec.
Pour obtenir des instructions détaillées, consultez le guide sur la création d’une spécification de connexion. Pour plus d’informations sur les propriétés et les valeurs utilisées pour une spécification de connexion, y compris des détails sur la configuration de l’authentification, de la source et des spécifications d’exploration, consultez le document options de configuration.
Mise à jour des spécifications de flux
Une fois que vous avez créé une spécification de connexion, vous devez ajouter la spécification de flux RestStorageToAEP pour permettre à votre source de créer un flux de données.
Les spécifications de flux contiennent des informations qui définissent un flux, notamment les identifiants de connexion source et cible pris en charge, les spécifications de transformation nécessaires à l’application aux données et les paramètres de planification requis pour générer un flux.
Pour obtenir des instructions détaillées, consultez le guide sur la mise à jour des spécifications de flux.
Mettre à jour votre spécification de connexion
Vous pouvez mettre à jour votre spécification de connexion en adressant une requête de PUT à l’API Flow Service. Pour plus d’informations, consultez le guide sur la mise à jour de vos spécifications de connexion .
Envoyer votre source
Pour envoyer votre source pour intégration à Experience Platform, vous devez d’abord terminer l’ensemble du workflow d’API Flow Service pour les sources afin de vous assurer que votre source fonctionne correctement. Si votre source s’exécute correctement, vous pouvez procéder et contacter votre représentant d’Adobe pour la vérification et la promotion. Pour plus d’informations, consultez le guide sur le test et envoi de votre source .
Étapes suivantes
Pour commencer à utiliser l’API Flow Service et créer une source par le biais de sources en libre-service (SDK par lots), lisez le guide de prise en main , puis sélectionnez l’un des guides de point de terminaison pour savoir comment utiliser des points de terminaison spécifiques.