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

Du måste slutföra autentiseringssjälvstudiekursen för att kunna ringa anrop till plattformsslutpunkter. 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 översiktsdokumentationen för sandlådan.

Rubrik för innehållstyp

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 är specifika för varje API-slutpunkt. Om ett specifikt Content-Type-värde krävs för en slutpunkt visas dess värde i de exempel-API-begäranden som tillhandahålls av API-guiderna 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 av Platform, inklusive exempel på JSON-schemaobjekt, kan du gå till guiden Grundläggande om Experience Platform API.

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, kan du gå till dokumentationen för Postman-plattformen.

Läser exempel-API-anrop sample-api

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 anropet i dess API-format, en mallrepresentation som endast visar åtgärden (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 Request som innehåller nödvändiga rubriker och fullständig "base path" som behövs för att interagera med API:t. Basbanan ska vara förpended för alla slutpunkter. Den tidigare /global/classes-slutpunkten blir till exempel 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 indikeras 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

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

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

Mer information om specifika slutpunkter i plattforms-API:er, inklusive obligatoriska huvuden och begärandetexter, finns i API-handböckerna för plattformen.

Plattforms-API-guider api-guides

API-guide
Beskrivning
Access Control API-guide
API-slutpunkten Access Control 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
Med API:t för Adobe Experience Platform Data Ingestion 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 följer ett känt schema i schemaregistret (XDM).
Catalog Service API-guide
Med API:t Catalog Service 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
Med API:t Data Access 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.
Edge Network Server API-guide
Edge Network Server API kan användas för en mängd olika användningsfall för datainsamling, personalisering, annonsering och marknadsföring. Server API kan användas på servrar, IoT-enheter, digitalboxar och en mängd andra enheter.
Identity Service API-guide
Med API:t Identity Service kan utvecklare hantera identifieringen av dina kunder i realtid av olika enheter, kanaler och nära nog alla kanaler 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 observationsvärden 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)
Med API:t Policy Service kan du skapa och hantera dataanvändningsetiketter och principer för att avgöra vilka marknadsföringsåtgärder som kan vidtas mot data som innehåller vissa dataanvändningsetiketter. Information om hur du använder etiketter på datauppsättningar och fält finns i Dataset Service API-handboken
Privacy Service API-guide
Med API:t Privacy Service kan utvecklare skapa och hantera kundförfrågningar för att få tillgång till eller ta bort sina personuppgifter mellan Experience Cloud-program, i enlighet med gällande sekretessbestämmelser.
Query Service API-guide
Med API:t Query Service 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)
Med API:t Schema Registry kan utvecklare programmässigt hantera alla scheman och relaterade XDM-resurser (Experience Data Model) inom Adobe Experience Platform.
Segmentation Service API-guide
Med API:t Segmentation Service 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)
API:t Sensei Machine Learning innehåller en mekanism för datavetare som organiserar och hanterar ML-tjänster (maskininlärning) från algoritmregistrering, experimenterande och tjänstdistribution.

Mer information om specifika slutpunkter och åtgärder som är tillgängliga för respektive tjänst finns i API-referensdokumentationen 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 i tabellen Plattforms-API-guider.

Svar på vanliga frågor finns i felsökningsguiden för plattformen.

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

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5