Aan de slag met Adobe Experience Platform API's
Adobe Experience Platform is ontwikkeld volgens een "API first"-filosofie. Met Experience Platform API's kunt u via programmacode elementaire CRUD-bewerkingen (Maken, Lezen, Bijwerken, Verwijderen) uitvoeren op gegevens, zoals het configureren van berekende kenmerken, het openen van gegevens/entiteiten, het exporteren van gegevens, het verwijderen van overbodige gegevens of batches, enzovoort.
De API's voor elke Experience Platform-service hebben allemaal dezelfde set verificatieheaders en gebruiken vergelijkbare syntaxis voor hun CRUD-bewerkingen. In de volgende handleiding worden de stappen beschreven die nodig zijn om aan de slag te gaan met Experience Platform API's.
Verificatie en kopteksten
Om vraag aan Experience Platform eindpunten met succes te maken, wordt u vereist om het authentificatieleerprogrammate voltooien. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in Experience Platform API-aanroepen, zoals hieronder wordt getoond:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Sandbox-header
Alle bronnen in Experience Platform zijn geïsoleerd naar specifieke virtuele sandboxen. Aanvragen aan Experience Platform API's vereisen een header die de naam aangeeft van de sandbox waarin de bewerking plaatsvindt:
x-sandbox-name: {SANDBOX_NAME}
Voor meer informatie over zandbakken in Experience Platform, zie de documentatie van het zandbakoverzicht.
Koptekst van inhoudstype
Alle verzoeken met een lading in het verzoeklichaam (zoals POST, PUT, en de vraag van PATCH) moeten een Content-Type
kopbal omvatten. Accepteerde waarden zijn specifiek voor elk API-eindpunt. Als een specifieke Content-Type
waarde voor een eindpunt nodig is, zal zijn waarde in de voorbeeld API verzoeken worden getoond die door de worden verstrekt API gidsen voor de individuele diensten van Experience Platform.
Basisprincipes van Experience Platform API
Adobe Experience Platform API's maken gebruik van verschillende onderliggende technologieën en syntaxis die belangrijk zijn om te begrijpen voor een effectief beheer van Experience Platform-bronnen.
Om meer over de onderliggende API technologieën te leren gebruikt Experience Platform, met inbegrip van voorbeeld JSON schemavoorwerpen, bezoek de fundamentele Experience Platform APIgids.
Postman-verzamelingen voor Experience Platform API's
Postman is een samenwerkingsplatform voor API-ontwikkeling waarmee u omgevingen kunt instellen met vooraf ingestelde variabelen, API-verzamelingen kunt delen, CRUD-aanvragen kunt stroomlijnen en nog veel meer. De meeste Experience Platform API-services beschikken over Postman-verzamelingen die kunnen worden gebruikt als hulpmiddel bij het maken van API-aanroepen.
Meer over Postman met inbegrip van hoe te opstelling een milieu, een lijst van beschikbare inzamelingen, en hoe te om inzamelingen in te voeren, bezoek de documentatie van Postman van Experience Platform.
API-voorbeeldaanroepen lezen sample-api
De aanvraagindelingen zijn afhankelijk van de Experience Platform API die wordt gebruikt. De beste manier om te leren hoe te om uw API vraag te structureren is door naast de voorbeelden te volgen die in de documentatie voor de bepaalde dienst van Experience Platform worden verstrekt u gebruikt.
In de documentatie voor Experience Platform worden op twee verschillende manieren voorbeeld-API-aanroepen weergegeven. Eerst, wordt de vraag voorgesteld in zijn API formaat, een malplaatjevertegenwoordiging die slechts de verrichting (GET, POST, PUT, PATCH, DELETE) en het eindpunt toont dat (bijvoorbeeld, /global/classes
) wordt gebruikt. Sommige malplaatjes tonen ook de plaats van variabelen helpen illustreren hoe een vraag, zoals GET /{VARIABLE}/classes/{ANOTHER_VARIABLE}
zou moeten worden geformuleerd.
De vraag wordt dan getoond als cURL bevelen in a Verzoek, die de noodzakelijke kopballen en volledige "basisweg"nodig omvat om met API met succes in wisselwerking te staan. Het basispad moet vooraf aan alle eindpunten worden toegevoegd. Het bovengenoemde /global/classes
-eindpunt wordt bijvoorbeeld https://platform.adobe.io/data/foundation/schemaregistry/global/classes
. De API-indeling/het aanvraagpatroon wordt in de hele documentatie weergegeven en u zult het volledige pad gebruiken dat in de voorbeeldaanvraag wordt getoond wanneer u zelf een aanroep naar Experience Platform API's maakt.
Voorbeeld-API-aanvraag
Hieronder ziet u een voorbeeld-API-aanvraag die de indeling weergeeft die u in de documentatie zult tegenkomen.
API formaat
De API-indeling toont de bewerking (GET) en het eindpunt dat wordt gebruikt. Variabelen worden aangegeven met accolades (in dit geval {CONTAINER_ID}
).
GET /{CONTAINER_ID}/classes
Verzoek
In deze voorbeeldaanvraag krijgen de variabelen van de API-indeling de werkelijke waarden in het aanvraagpad. Bovendien, worden alle vereiste kopballen getoond als of waarden van de steekproefkopbal of variabelen waar de gevoelige informatie (zoals veiligheidstokens en toegangsIDs) zou moeten worden omvat.
curl -X GET \
https://platform.adobe.io/data/foundation/schemaregistry/global/classes \
-H 'Accept: application/vnd.adobe.xed-id+json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Reactie
De reactie illustreert wat u zou verwachten te ontvangen na een succesvolle vraag aan API, die op het verzoek wordt gebaseerd dat werd verzonden. Soms wordt de reactie afgebroken voor de ruimte, wat betekent dat u meer informatie of aanvullende informatie ziet voor de hoeveelheid die in het voorbeeld wordt weergegeven.
{
"results": [
{
"title": "XDM ExperienceEvent",
"$id": "https://ns.adobe.com/xdm/context/experienceevent",
"meta:altId": "_xdm.context.experienceevent",
"version": "1"
},
{
"title": "XDM Individual Profile",
"$id": "https://ns.adobe.com/xdm/context/profile",
"meta:altId": "_xdm.context.profile",
"version": "1"
}
],
"_links": {}
}
Foutberichten
De het oplossen van problemengids van Experience Platformverstrekt een lijst van fouten die u wanneer het gebruiken van om het even welke dienst van Experience Platform kunt ontmoeten.
Voor het oplossen van problemengidsen op de individuele diensten van Experience Platform, zie de folder van het de dienstoplossen van problemen.
Voor meer informatie over specifieke eindpunten in Experience Platform APIs, met inbegrip van vereiste kopballen en verzoekorganismen, gelieve te zien de Experience Platform API gidsen.
Experience Platform API-hulplijnen api-guides
(het Beheer van Gegevens)
(de Wetenschap van Gegevens Workspace)
Voor meer informatie over specifieke eindpunten en verrichtingen beschikbaar voor elke dienst, te zien gelieve de API verwijzingsdocumentatieop Adobe I/O.
Volgende stappen
In dit document zijn de vereiste kopteksten, beschikbare hulplijnen en een voorbeeld-API-aanroep geïntroduceerd. Nu u de vereiste kopbalwaarden nodig hebt om API vraag op Adobe Experience Platform te maken, selecteer een API eindpunt u van de Experience Platform API gidsen lijstwenst te onderzoeken.
Voor antwoorden op vaak gestelde vragen, verwijs naar de het oplossen van problemengids van Experience Platform.
Om opstelling een milieu van Postman en de beschikbare inzamelingen van Postman te onderzoeken, verwijs naar de gids van Postman van Experience Platform.