Komma igång med Policy Service-API:t
Med API:t Policy Service kan du skapa och hantera olika resurser för Adobe Experience Platform datastyrning. Det här dokumentet innehåller en introduktion till de centrala koncept som du behöver känna till innan du försöker anropa API:t Policy Service.
Förhandskrav
Om du vill använda utvecklarhandboken måste du ha en fungerande förståelse för de olika Experience Platform-tjänsterna som används i arbetet med datastyrningsfunktioner. Innan du börjar arbeta med Policy Service API bör du läsa dokumentationen för följande tjänster:
- Datastyrning: Ramverket som Experience Platform använder för att framtvinga efterlevnad av dataanvändning.
- Experience Data Model (XDM) System: Det standardiserade ramverket som Experience Platform organiserar kundupplevelsedata med.
- Real-Time Customer Profile: Tillhandahåller en enhetlig konsumentprofil i realtid baserad på aggregerade data från flera källor.
- Sandlådor: 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.
Läser exempel-API-anrop
API-dokumentationen för Policy Service innehåller exempel på API-anrop som visar hur du formaterar dina begäranden. 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 resurser i Experience Platform, inklusive de som tillhör Datastyrning, är isolerade till specifika virtuella sandlådor. Alla begäranden till Platform API:er kräver en rubrik som anger namnet på sandlådan som åtgärden ska utföras i:
x-sandbox-name: {SANDBOX_NAME}
Alla begäranden som innehåller en nyttolast (POST, PUT, PATCH) kräver ytterligare en rubrik:
Content-Type: application/json
Kärna eller anpassade resurser
I API:t Policy Service kallas alla principer och marknadsföringsåtgärder antingen core eller custom resurser.
core-resurser är de som definieras och underhålls av Adobe, medan custom-resurser är de som skapas och underhålls av din organisation och därför är unika och synliga enbart för din organisation. Därför är listnings- och uppslagsåtgärder (GET) de enda åtgärder som tillåts för core-resurser, medan listnings-, uppslags- och uppdateringsåtgärder (POST, PUT, PATCH och DELETE) är tillgängliga för custom-resurser.
Nästa steg
Välj en av de tillgängliga slutpunktsguiderna för att börja ringa anrop med hjälp av API:t för principtjänsten.