Query Service API-handleiding
Deze handleiding voor ontwikkelaars bevat stappen voor het uitvoeren van verschillende bewerkingen in de Adobe Experience Platform Query Service API.
Aan de slag
Deze handleiding vereist een goed begrip van de verschillende Adobe Experience Platform-services die bij het gebruik van Query Service betrokken zijn.
- Query Service: biedt de mogelijkheid om query's uit te voeren op gegevenssets en de resulterende query's vast te leggen als nieuwe gegevenssets in Experience Platform .
- Experience Data Model (XDM) System: Het gestandaardiseerde framework waarmee Experience Platform gegevens voor de klantervaring indeelt.
- Sandboxes: Experience Platform biedt virtuele sandboxen die één Platform -instantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.
De volgende secties bevatten aanvullende informatie die u moet weten voordat u Query Service kunt gebruiken met de API.
API-voorbeeldaanroepen lezen
Deze gids verstrekt voorbeeld API vraag om aan te tonen hoe te om uw verzoeken te formatteren. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de overeenkomsten die in deze documentatie voor steekproef API vraag worden gebruikt, zie de sectie op hoe te om voorbeeld API vraagin de Experience Platform het oplossen van problemengids te lezen.
Waarden verzamelen voor vereiste koppen
Om vraag aan Experience Platform APIs te maken, moet u het authentificatieleerprogrammaeerst voltooien. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in alle API-aanroepen van Platform , zoals hieronder wordt getoond:
- Autorisatie:
Bearer {ACCESS_TOKEN} - x-api-key:
{API_KEY} - x-gw-ims-org-id:
{ORG_ID}
Alle bronnen in Experience Platform zijn geïsoleerd naar specifieke virtuele sandboxen. Alle aanvragen naar Platform API's vereisen een header die de naam aangeeft van de sandbox waarin de bewerking plaatsvindt:
- x-sandbox-name:
{SANDBOX_NAME}
Voorbeeld-API-aanroepen
Nu u begrijpt welke headers u moet gebruiken, bent u klaar om aanroepen uit te voeren naar de Query Service API. De volgende documenten doorlopen de verschillende API-aanroepen die u met de API Query Service kunt maken. Elke voorbeeldvraag omvat het algemene API formaat, een steekproefverzoek die vereiste kopballen toont, en een steekproefreactie.
Volgende stappen
Nu u hebt geleerd hoe u aanroepen kunt maken met de API Query Service , kunt u uw eigen niet-interactieve query's maken. Voor meer informatie over hoe te om vragen tot stand te brengen, te lezen gelieve de SQL verwijzingsgids.