Query Service API-guide

Den här utvecklarhandboken innehåller steg för att utföra olika åtgärder i Adobe Experience Platform Query Service API.

Komma igång

Den här guiden kräver en fungerande förståelse för de olika Adobe Experience Platform-tjänster som används för Query Service.

Query Service: Ger möjlighet att fråga datauppsättningar och hämta de resulterande frågorna som nya datauppsättningar i Experience Platform.
Experience Data Model (XDM) System: Det standardiserade ramverk som Experience Platform organiserar kundupplevelsedata.
Sandboxes: 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.

I följande avsnitt finns ytterligare information som du behöver känna till för att kunna använda Query Service med API:t.

Läser exempel-API-anrop

Den här guiden 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 den här dokumentationen för exempel-API-anrop finns i avsnittet om läsa exempel-API-anrop i Experience Platform felsökningsguide.

Samla in värden för obligatoriska rubriker

För att ringa Experience Platform API:er måste du först 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 alla Platform API-anrop enligt nedan:

Behörighet: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}

Alla resurser i Experience Platform isoleras till specifika virtuella sandlådor. Alla förfrågningar till Platform API:er kräver ett huvud som anger namnet på den sandlåda där åtgärden ska utföras:

x-sandbox-name: {SANDBOX_NAME}

OBSERVERA

Mer information om hur du arbetar med sandlådor i Experience Platform, se översikt över sandlådor.

Exempel på API-anrop

Nu när du förstår vilka rubriker du ska använda kan du börja ringa till Query Service API. Följande dokument går igenom de olika API-anropen som du kan göra med Query Service API. Varje exempelanrop innehåller det allmänna API-formatet, en exempelbegäran med obligatoriska rubriker och ett exempelsvar.

Nästa steg

Nu när du har lärt dig hur man ringer med Query Service API kan du skapa egna icke-interaktiva frågor. Mer information om hur du skapar frågor finns i SQL-referenshandbok.