Komma igång med Policy Service API

The Policy Service Med API 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 du behöver känna innan du försöker ringa till Policy Service API.

Förutsättningar

Att använda utvecklarhandboken kräver en fungerande förståelse av de olika Experience Platform tjänster som används i arbetet med datastyrningsfunktioner. Innan du börjar arbeta med Policy Service API, läs dokumentationen för följande tjänster:

  • Datastyrning: Den ram som Experience Platform regelefterlevnad för dataanvändning.
  • Experience Data Model (XDM) System: Det standardiserade ramverk som Experience Platform organiserar kundupplevelsedata.
  • Real-time Customer Profile: Ger 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 enda Platform till separata virtuella miljöer för att utveckla och utveckla applikationer för digitala upplevelser.

Läser exempel-API-anrop

The Policy Service API-dokumentationen 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 konventionerna som används i dokumentationen för exempel-API-anrop finns i avsnittet om läsa exempel-API-anrop i Experience Platform felsökningsguide.

Obligatoriska rubriker

API-dokumentationen kräver också att du har slutfört självstudiekurs om autentisering för att kunna ringa Platform slutpunkter. När du är klar med självstudiekursen för autentisering visas värdena för var och en av de rubriker som krävs i Experience Platform API-anrop enligt nedan:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Alla resurser i Experience Platform, inklusive sådana som tillhör datastyrning, isoleras till specifika virtuella sandlådor. Alla förfrågningar 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}
OBSERVERA

Mer information om sandlådor i Platform, se översiktsdokumentation för sandlåda.

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 Policy Service API, alla policyer och marknadsföringsåtgärder kallas antingen core eller custom resurser.

core är de som definieras och bibehålls av Adobe, medan custom är resurser som skapats och underhålls av organisationen och därför är unika och synliga endast för IMS-organisationen. Listans- och uppslagsåtgärder (GET) är de enda operationerna som tillåts på core resurser, medan åtgärder för listning, sökning och uppdatering (POST, PUT, PATCHoch DELETE) finns för custom resurser.

Nästa steg

Om du vill börja ringa anrop med hjälp av API:t för principtjänsten väljer du en av de tillgängliga slutpunktsguiderna.

På denna sida