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.
- Query Service: Verstrekt de capaciteit om datasets te vragen en de resulterende vragen als nieuwe datasets in te vangen Experience Platform.
- Experience Data Model (XDM) System: Het gestandaardiseerde kader waarbinnen Experience Platform organiseert de gegevens van de klantenervaring.
- Sandboxes: Experience Platform biedt virtuele sandboxen die één enkele partitie maken Platform in afzonderlijke virtuele omgevingen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.
In de volgende secties vindt u aanvullende informatie die u moet weten om deze te kunnen gebruiken Query Service 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 conventies die in deze documentatie worden gebruikt voor voorbeeld-API-aanroepen raadpleegt u de sectie over voorbeeld-API-aanroepen lezen in de Experience Platform gids voor probleemoplossing.
Waarden verzamelen voor vereiste koppen
Om vraag te maken aan Experience Platform API's, moet u eerst de verificatiezelfstudie. Het voltooien van de zelfstudie over verificatie biedt de waarden voor elk van de vereiste kopteksten in alle Platform API-aanroepen, 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 verzoeken aan 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 kopballen aan gebruik zijn, bent u bereid beginnen het richten van vraag aan Query Service API. De volgende documenten doorlopen de verschillende API-aanroepen die u kunt maken met de Query Service API. Elke voorbeeldvraag omvat het algemene API formaat, een steekproefverzoek die vereiste kopballen toont, en een steekproefreactie.
Volgende stappen
Nu hebt u geleerd hoe te om vraag te maken gebruikend Query Service API, kunt u uw eigen niet-interactieve vragen maken. Lees voor meer informatie over het maken van query's de SQL-naslaggids.