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.

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a