Komma igång med Adobe Experience Platform API:er

Adobe Experience Platform utvecklas under en"API first"-filosofi. Med hjälp av plattforms-API:er kan du programmässigt utföra grundläggande CRUD-åtgärder (Skapa, Läs, Uppdatera, Ta bort) mot data, som att konfigurera beräknade attribut, komma åt data/enheter, exportera data, ta bort onödiga data eller batchar med mera.

API:erna för varje Experience Platform-tjänst har alla samma uppsättning autentiseringsrubriker och använder liknande syntax för sina CRUD-åtgärder. Följande guide beskriver de steg som krävs för att komma igång med plattforms-API:er.

Autentisering och rubriker

För att kunna ringa anrop till plattformsslutpunkter måste du slutföra självstudiekurs om autentisering. När du är klar med 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}

Sandlådehuvud

Alla resurser i Experience Platform är isolerade till specifika virtuella sandlådor. Begäranden till plattforms-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 plattformen finns i översiktsdokumentation för sandlåda.

Rubrik för innehållstyp

Alla förfrågningar med en nyttolast i begärandetexten (t.ex. samtal av typen POST, PUT och PATCH) måste innehålla en Content-Type header. Godkända värden är specifika för varje API-slutpunkt. Om en specifik Content-Type värdet behövs för en slutpunkt, och dess värde visas i de exempel-API-begäranden som tillhandahålls av API-guider för enskilda plattformstjänster.

Grundläggande om Experience Platform API

Adobe Experience Platform API:er använder flera underliggande tekniker och syntaxer som är viktiga att förstå för att effektivt hantera plattformsresurser.

Om du vill veta mer om de underliggande API-teknikerna som används i Platform, inklusive exempel på JSON-schemaobjekt, kan du besöka Grundläggande om Experience Platform API guide.

Postman-samlingar för Experience Platform API:er

Postman är en samarbetsplattform för API-utveckling som gör att du kan konfigurera miljöer med förinställda variabler, dela API-samlingar, effektivisera CRUD-begäranden och mycket annat. De flesta Platform API-tjänster har Postman-samlingar som kan användas för att göra API-anrop.

Om du vill veta mer om Postman, t.ex. om hur du konfigurerar en miljö, en lista över tillgängliga samlingar och hur du importerar samlingar, går du till Postman-dokumentation.

Läser exempel-API-anrop

Format för förfrågningar varierar beroende på vilken plattform-API som används. Det bästa sättet att lära sig att strukturera API-anrop är att följa med exemplen i dokumentationen för den plattformstjänst du använder.

Dokumentationen för Experience Platform visar exempel på API-anrop på två olika sätt. Först presenteras samtalet i API-format, en mallrepresentation som endast visar operationen (GET, POST, PUT, PATCH, DELETE) och den slutpunkt som används (till exempel /global/classes). Vissa mallar visar också var variablerna finns för att illustrera hur ett anrop ska formuleras, till exempel GET /{VARIABLE}/classes/{ANOTHER_VARIABLE}.

Anropen visas sedan som cURL-kommandon i en Begäran, som innehåller nödvändiga rubriker och fullständig "bassökväg" som behövs för att interagera med API:t. Basbanan ska vara förpended för alla slutpunkter. Ovannämnda /global/classes slutpunkten blir https://platform.adobe.io/data/foundation/schemaregistry/global/classes. Du kommer att se API-formatet/begäranmönstret i hela dokumentationen och förväntas använda den fullständiga sökvägen som visas i exempelbegäran när du anropar egna API:er för plattformen.

Exempel på API-begäran

Följande är ett exempel på en API-begäran som visar vilket format du kommer att stöta på i dokumentationen.

API-format

API-formatet visar åtgärden (GET) och slutpunkten som används. Variabler anges med klammerparenteser (i det här fallet {CONTAINER_ID}).

GET /{CONTAINER_ID}/classes

Begäran

I den här exempelbegäran får variablerna från API-formatet faktiska värden i sökvägen för begäran. Dessutom visas alla obligatoriska rubriker som antingen exempelvärden för rubriker eller variabler där känslig information (t.ex. säkerhetstoken och åtkomst-ID) ska inkluderas.

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/global/classes \
  -H 'Accept: application/vnd.adobe.xed-id+json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Svar

Svaret visar vad du förväntar dig efter ett lyckat anrop till API:t, baserat på den begäran som skickades. Ibland kortas svaret av för blanksteg, vilket innebär att du kan se mer information eller mer information än den som visas i exemplet.

{
    "results": [
        {
            "title": "XDM ExperienceEvent",
            "$id": "https://ns.adobe.com/xdm/context/experienceevent",
            "meta:altId": "_xdm.context.experienceevent",
            "version": "1"
        },
        {
            "title": "XDM Individual Profile",
            "$id": "https://ns.adobe.com/xdm/context/profile",
            "meta:altId": "_xdm.context.profile",
            "version": "1"
        }
    ],
    "_links": {}
}

Felmeddelanden

The Felsökningsguide för plattformen innehåller en lista med fel som kan uppstå när du använder en Experience Platform-tjänst.

Felsökningsguider för enskilda plattformstjänster finns i tjänstfelsökningskatalog.

Mer information om specifika slutpunkter i plattforms-API:er, inklusive obligatoriska rubriker och begärandetexter, finns i Plattforms-API-guider.

Plattforms-API-guider

API-guide Beskrivning
Access Control API-guide The Access Control API-slutpunkten kan hämta aktuella principer som gäller för en användare för angivna resurser inom en angiven sandlåda. Alla andra åtkomstkontrollfunktioner tillhandahålls via Adobe Admin Console.
API-guide för gruppinmatning Adobe Experience Platform Data Ingestion Med API kan du importera data till plattformen som gruppfiler. Data som importeras kan vara profildata från en platt fil i ett CRM-system (till exempel en Parquet-fil) eller data som överensstämmer med ett känt schema i schemaregistret (XDM).
Catalog Service API-guide The Catalog Service Med API kan utvecklare hantera datauppsättningsmetadata i Adobe Experience Platform. Detta omfattar dataplatser, bearbetningsfaser, fel som inträffade under bearbetningen samt datarapporter.
Data Access API-guide The Data Access Med API kan utvecklare hämta information om inkapslade datauppsättningar i Experience Platform. Detta inkluderar åtkomst och hämtning av datauppsättningsfiler, hämtning av rubrikinformation, listning av misslyckade och slutförda grupper samt hämtning av CSV-/Parquet-filer för förhandsgranskning.
Dataset Service API-guide Med API:t för datauppsättningstjänsten kan du tillämpa och redigera användningsetiketter för datauppsättningar. Den ingår i Adobe Experience Platform datakatalogfunktioner, men är skild från katalogtjänstens API, som hanterar datauppsättningsmetadata.
Identity Service API-guide The Identity Service Med API kan utvecklare hantera enhetsoberoende, kanalövergripande och i stort sett realtidsidentifiering av kunder med hjälp av identitetsdiagram i Adobe Experience Platform.
Observability Insights API-guide Observability Insights är ett RESTful-API som gör att utvecklare kan visa viktiga mätvärden för observerbarhet i Adobe Experience Platform. Dessa mätvärden ger insikter i statistik om plattformsanvändning, hälsokontroller för plattformstjänster, historiska trender och resultatindikatorer för olika plattformsfunktioner.
Policy Service API-guide
(Datastyrning)
The Policy Service Med API kan ni skapa och hantera etiketter och principer för dataanvändning för att avgöra vilka marknadsföringsåtgärder som kan vidtas mot data som innehåller vissa etiketter för dataanvändning. Om du vill använda etiketter på datauppsättningar och fält kan du läsa Dataset Service API guide
Privacy Service API-guide The Privacy Service Med API kan utvecklare skapa och hantera kundförfrågningar för att få tillgång till eller ta bort sina personuppgifter mellan olika Experience Cloud-program, i enlighet med gällande sekretessbestämmelser.
Query Service API-guide The Query Service Med API kan utvecklare fråga sina Adobe Experience Platform-data med hjälp av standard-SQL.
Real-Time Customer Profile API-guide Med Real-Time Customer Profile API kan utvecklare utforska och arbeta med profildata, inklusive visningsprofiler, skapa och uppdatera sammanfogningsprinciper, exportera eller sampla profildata och ta bort profildata som inte längre behövs eller som har lagts till av misstag.
API-guide för sandlådor Med sandbox-API kan utvecklare programmässigt hantera isolerade virtuella sandlådemiljöer i Adobe Experience Platform.
Schema Registry API-guide
(XDM)
The Schema Registry Med API kan utvecklare programmässigt hantera alla scheman och relaterade XDM-resurser (Experience Data Model) inom Adobe Experience Platform.
Segmentation Service API-guide The Segmentation Service Med API kan utvecklare programmässigt hantera segmenteringsåtgärder i Adobe Experience Platform. Detta inkluderar att bygga segment och generera målgrupper från kundprofildata i realtid.
Sensei Machine Learning API-guide
(Data Science Workspace)
The Sensei Machine Learning API har en mekanism för datavetare som organiserar och hanterar maskininlärningstjänster (ML) från algoritmintroduktion, experimenterande och driftsättning.

Mer information om specifika slutpunkter och åtgärder som är tillgängliga för respektive tjänst finns i API-referensdokumentation på Adobe I/O.

Nästa steg

I det här dokumentet introducerades nödvändiga rubriker, tillgängliga guider och ett exempel på API-anrop. Nu när du har de rubrikvärden som krävs för att göra API-anrop på Adobe Experience Platform väljer du en API-slutpunkt som du vill utforska från Tabell för API-guider för plattformen.

Svar på vanliga frågor finns i Felsökningsguide för plattformen.

Om du vill konfigurera en Postman-miljö och utforska de tillgängliga Postman-samlingarna kan du läsa Plattformsguide för Postman.

På denna sida