Komma igång med API för datainmatning getting-started
Med API-slutpunkter för datainmatning kan du utföra grundläggande CRUD-åtgärder för att importera data i Adobe Experience Platform.
API-guiderna kräver en fungerande förståelse för flera Adobe Experience Platform-tjänster som arbetar med data. Innan du använder API:t för datainmatning bör du läsa dokumentationen för följande tjänster:
- Gruppinmatning: Gör att du kan importera data till Adobe Experience Platform som gruppfiler.
- Real-Time Customer Profile: Tillhandahåller en enhetlig kundprofil i realtid baserad på aggregerade data från flera källor.
- Experience Data Model (XDM): Det standardiserade ramverk som Platform använder för att organisera kundupplevelsedata.
- Sandboxes: Experience Platform innehåller virtuella sandlådor som partitionerar en enskild Platform-instans till separata virtuella miljöer för att hjälpa till att utveckla och utveckla program för digitala upplevelser.
I följande avsnitt finns ytterligare information som du behöver känna till för att kunna anropa API-slutpunkter för Profile.
Läser exempel-API-anrop
API-dokumentationen för datainmatning innehåller exempel på API-anrop som visar hur begäranden formateras korrekt. Det kan vara sökvägar, obligatoriska rubriker och korrekt formaterade begärandenyttolaster. Ett exempel på JSON som returneras i API-svar finns också. Information om de konventioner som används i dokumentationen för exempel-API-anrop finns i avsnittet Så här läser du exempel-API-anrop i felsökningsguiden för Experience Platform.
Obligatoriska rubriker
API-dokumentationen kräver också att du har slutfört autentiseringssjälvstudiekursen för att kunna anropa Platform-slutpunkter. När du slutför självstudiekursen för autentisering visas värdena för var och en av de obligatoriska rubrikerna i Experience Platform API-anrop, vilket visas nedan:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Alla begäranden med en nyttolast i begärandetexten (till exempel anropen POST, PUT och PATCH) måste innehålla en Content-Type-rubrik. Godkända värden som är specifika för varje anrop finns i anropsparametrarna.
Alla resurser i Experience Platform är isolerade till specifika virtuella sandlådor. Begäranden till Platform API:er kräver ett huvud som anger namnet på sandlådan som åtgärden ska utföras i:
x-sandbox-name: {SANDBOX_NAME}
Mer information om sandlådor i Platform finns i översiktsdokumentationen för sandlådan.