[Beta]{class="badge informative"}
Guida introduttiva alle origini self-service (Streaming SDK)
Origini self-service (Streaming SDK) consente di integrare la propria origine per portare i dati in streaming a Adobe Experience Platform. Questo documento fornisce un'introduzione ai concetti di base che è necessario conoscere prima di tentare di effettuare chiamate all'Flow Service API.
Processo di alto livello
Di seguito è descritta la procedura dettagliata per configurare l’origine in Experience Platform:
Integrazione
Documentazione
- Per iniziare a documentare l'origine, leggere la panoramica sulla creazione della documentazione per le origini self-service.
- Per i passaggi su come creare la documentazione utilizzando GitHub, leggi la guida su utilizzo dell'interfaccia Web GitHub.
- Leggi la guida su utilizzo di un editor di testo per i passaggi su come creare documentazione utilizzando il computer locale.
- Utilizzare il modello di documentazione API Streaming SDK per documentare l'origine nell'API.
- Utilizzare il modello di documentazione dell'interfaccia utente di Streaming SDK per documentare l'origine nell'interfaccia utente.
Puoi scaricare i modelli di documentazione riportati di seguito:
Prerequisiti
Per utilizzare Origini self-service (Streaming SDK), è necessario assicurarsi di avere accesso a un’organizzazione sandbox con provisioning Adobe Experience Platform Sources.
Questa guida richiede anche una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
- Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Experience Platform.
- Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.
Lettura delle chiamate API di esempio
Nella documentazione di Origini self-service (Streaming SDK) e API Flow Service sono disponibili esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un codice JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione su come leggere chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.
Raccogliere i valori per le intestazioni richieste
Per effettuare chiamate alle API di Experience Platform, devi prima completare l'esercitazione di autenticazione. Completando il tutorial sull’autenticazione si ottengono i valori per ciascuna delle intestazioni richieste in tutte le chiamate API di Experience Platform, come mostrato di seguito:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Tutte le risorse in Experience Platform, incluse quelle appartenenti a Flow Service, sono isolate in sandbox virtuali specifiche. Tutte le richieste alle API di Experience Platform richiedono un’intestazione che specifichi il nome della sandbox in cui verrà eseguita l’operazione:
x-sandbox-name: {SANDBOX_NAME}
Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un’intestazione aggiuntiva:
Content-Type: application/json
Passaggi successivi
Per iniziare a creare una nuova origine con origini self-service (Streaming SDK), consulta l'esercitazione sulla creazione di una nuova origine.