Guida API per le origini self-service (SDK Batch)
Questo documento fornisce una panoramica del processo di creazione di una nuova origine, inclusi i passaggi su come scrivere e inviare una nuova specifica di connessione utilizzando Flow Service API.
Flow Service viene utilizzato per raccogliere e centralizzare i dati dei clienti da diverse origini in Platform. Il servizio fornisce un’interfaccia utente e un’API RESTful che consentono di impostare facilmente le connessioni sorgente a vari provider di dati. Queste connessioni di origine ti consentono di autenticare i sistemi di terze parti, impostare i tempi per le esecuzioni dell’acquisizione e gestire la velocità effettiva di acquisizione dei dati.
L'API Flow Service fornisce diversi endpoint che consentono di gestire in modo programmatico le specifiche di connessione e flusso per una nuova origine che si sta integrando tramite Self-Service Sources (Batch SDK).
Crea una nuova specifica di connessione
Il primo passaggio nella configurazione di una nuova origine consiste nel creare una nuova specifica di connessione.
Le specifiche di connessione restituiscono le proprietà del connettore di un'origine. Includono specifiche di autenticazione relative alla creazione delle connessioni di base e di origine e un ID di specifica di connessione fisso assegnato a una determinata origine. Le specifiche di connessione sono indipendenti dal tenant e dall’organizzazione. Una specifica di connessione tipica contiene informazioni di base su una determinata origine e tre sezioni distinte: authSpec
, sourceSpec
e exploreSpec
.
Per istruzioni dettagliate, consulta la guida su creazione di una nuova specifica di connessione. Per informazioni sulle proprietà e i valori utilizzati per una specifica di connessione, inclusi i dettagli sulla configurazione dell'autenticazione, le specifiche di origine ed esplorazione, vedere il documento sulle opzioni di configurazione.
Aggiorna specifiche di flusso
Dopo aver creato correttamente una specifica di connessione, è necessario aggiungere la specifica di flusso RestStorageToAEP
per consentire all'origine di creare un flusso di dati.
Le specifiche di flusso contengono informazioni che definiscono un flusso, inclusi gli ID di connessione di origine e di destinazione supportati, le specifiche di trasformazione da applicare ai dati e i parametri di programmazione necessari per generare un flusso.
Per istruzioni dettagliate, vedere la guida all'aggiornamento delle specifiche di flusso.
Aggiornare le specifiche di connessione
È possibile aggiornare le specifiche di connessione effettuando una richiesta PUT all'API Flow Service. Per ulteriori informazioni, consulta la guida sull'aggiornamento delle specifiche di connessione.
Invia l'origine
Per inviare ad Experience Platform l'origine per l'integrazione, è necessario prima completare l'intero flusso di lavoro API Flow Service per le origini per garantire il corretto funzionamento dell'origine. Se l’origine viene eseguita correttamente, puoi procedere e contattare il rappresentante dell’Adobe per la verifica e la promozione. Per ulteriori informazioni, consulta la guida su verifica e invio dell'origine
Passaggi successivi
Per iniziare a utilizzare l'API Flow Service e creare una nuova origine tramite Self-Serve Sources (Batch SDK), leggere la guida introduttiva, quindi selezionare una delle guide degli endpoint per informazioni su come utilizzare endpoint specifici.