Aan de slag met de API voor gegevensverwerking getting-started
Met de eindpunten van de API voor gegevensinname kunt u standaard-CRUD-bewerkingen uitvoeren om gegevens in Adobe Experience Platform in te voeren.
Het gebruik van de API-handleidingen vereist een goed begrip van de verschillende Adobe Experience Platform-services die betrokken zijn bij het werken met gegevens. Lees de documentatie voor de volgende services voordat u de API voor gegevensinname gebruikt:
- Inname van de Partij: Staat u toe om gegevens in Adobe Experience Platform als partijdossiers in te voeren.
- Real-Time Customer Profile: biedt een uniform, klantprofiel in real-time op basis van geaggregeerde gegevens van meerdere bronnen.
- Experience Data Model (XDM): Het gestandaardiseerde framework waarmee Platform gegevens voor klantervaring organiseert.
- 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 om aanroepen van Profile API-eindpunten te kunnen uitvoeren.
API-voorbeeldaanroepen lezen
De documentatie van de API van de Ingestie van Gegevens verstrekt voorbeeld API vraag om aan te tonen hoe te behoorlijk verzoeken 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 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.
Vereiste koppen
De API documentatie vereist u ook om het authentificatieleerprogrammate voltooien om vraag aan Platform eindpunten met succes te maken. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in API-aanroepen van Experience Platform , zoals hieronder wordt getoond:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Alle verzoeken met een lading in het verzoeklichaam (zoals POST, PUT, en de vraag van PATCH) moeten een Content-Type kopbal omvatten. De toegelaten waarden specifiek voor elke vraag worden verstrekt in de vraagparameters.
Alle bronnen in Experience Platform zijn geïsoleerd naar specifieke virtuele sandboxen. Voor aanvragen van Platform API's is een header vereist die de naam aangeeft van de sandbox waarin de bewerking plaatsvindt:
x-sandbox-name: {SANDBOX_NAME}
Voor meer informatie over zandbakken in Platform, zie de documentatie van het zandbakoverzicht.