[Beta]{class="badge informative"}
Aan de slag met Self-Serve Bronnen (Streaming SDK)
Met Self-Serve Sources (Streaming SDK) kunt u uw eigen bron integreren en streaming gegevens naar Adobe Experience Platform overbrengen. Dit document verstrekt een inleiding aan de kernconcepten u moet kennen alvorens te proberen om vraag aan Flow Service APIte maken.
Proces op hoog niveau
Het stapsgewijze proces voor het configureren van uw bron in Experience Platform wordt hieronder beschreven:
Integratie
Documentatie
- Begin documenterend uw bron, lees het overzicht bij het creëren van documentatie voor Zelfbediening Bronnen.
- Lees de gids op gebruikend de het Webinterface van GitHubvoor stappen op hoe te om documentatie tot stand te brengen die GitHub gebruikt.
- Lees de gids op gebruikend een tekstredacteurvoor stappen op hoe te om documentatie tot stand te brengen gebruikend uw lokale machine.
- Gebruik het Streaming SDK API documentatiesjabloon om uw bron in APIte documenteren.
- gebruik het het stromen de documentatiemalplaatje van SDK UI om uw bron in UIte documenteren.
U kunt ook de onderstaande documentatiesjablonen downloaden:
Vereisten
Als u Self-Serve Sources (Streaming SDK) wilt gebruiken, moet u ervoor zorgen dat u toegang hebt tot een sandboxorganisatie die is ingericht met Adobe Experience Platform Sources.
Deze handleiding vereist ook een goed begrip van de volgende onderdelen van Adobe Experience Platform:
- Bronnen: Experience Platform staat gegevens toe om van diverse bronnen worden opgenomen terwijl het voorzien van u van de capaciteit om, inkomende gegevens te structureren te etiketteren en te verbeteren gebruikend de diensten van Experience Platform.
- Sandboxes: Experience Platform verstrekt virtuele zandbakken die één enkele instantie van Experience Platform in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.
API-voorbeeldaanroepen lezen
De Self-Serve Bronnen (Streaming SDK) en de Flow Service API-documentatie bieden voorbeeld-API-aanroepen om aan te tonen hoe uw aanvragen moeten worden opgemaakt. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de overeenkomsten die in documentatie voor steekproef API vraag worden gebruikt, zie de sectie op hoe te om voorbeeld API vraagin de het oplossen van problemengids van Experience Platform te lezen.
Waarden verzamelen voor vereiste koppen
Om vraag aan Experience Platform APIs te maken, moet u het authentificatieleerprogrammaeerst voltooien. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in alle API-aanroepen van Experience Platform , zoals hieronder wordt getoond:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Alle bronnen in Experience Platform, inclusief die van Flow Service , zijn geïsoleerd naar specifieke virtuele sandboxen. Alle aanvragen aan Experience Platform API's vereisen een header die de naam aangeeft van de sandbox waarin de bewerking plaatsvindt:
x-sandbox-name: {SANDBOX_NAME}
Alle verzoeken die een lading (POST, PUT, PATCH) bevatten vereisen een extra kopbal:
Content-Type: application/json
Volgende stappen
Beginnen creërend een nieuwe bron met Zelfbediening Bronnen (het stromen SDK), zie het leerprogramma op creërend een nieuwe bron.