Erste Schritte mit der Datenaufnahme-API getting-started
Mithilfe von API-Endpunkten für die Datenaufnahme können Sie grundlegende CRUD-Vorgänge durchführen, um Daten in Adobe Experience Platform aufzunehmen.
Die Verwendung der -API-Handbücher setzt ein grundlegendes Verständnis mehrerer Adobe Experience Platform-Services voraus, die an der Arbeit mit -Daten beteiligt sind. Bevor Sie die Datenaufnahme-API verwenden, lesen Sie die Dokumentation für die folgenden Services:
- Batch-Erfassung: Erlaubt Ihnen das Erfassen von Daten in Adobe Experience Platform in Form von Batch-Dateien.
- Real-Time Customer Profile: Bietet ein einheitliches Kundenprofil in Echtzeit, das auf aggregierten Daten aus verschiedenen Quellen basiert.
- Experience Data Model (XDM): Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten ordnet.
- Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Experience Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse besser entwickeln und weiterentwickeln können.
Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um Profile API-Endpunkte erfolgreich aufrufen zu können.
Lesen von Beispiel-API-Aufrufen
In der Dokumentation zur Datenaufnahme-API wird anhand von Beispielen für API-Aufrufe die korrekte Formatierung von Anfragen aufgezeigt. Dazu gehören Pfade, erforderliche Kopfzeilen und ordnungsgemäß formatierte Anfrage-Payloads. Außerdem wird ein Beispiel für eine von der API im JSON-Format zurückgegebene Antwort bereitgestellt. Informationen zu den Konventionen, die in der Dokumentation für Beispiel-API-Aufrufe verwendet werden, finden Sie im Abschnitt zum Lesen von Beispiel-API-Aufrufen im Handbuch zur Fehlerbehebung für Experience Platform
Erforderliche Kopfzeilen
Außerdem setzt die API-Dokumentation voraus, dass Sie das Authentifizierungs-Tutorial abgeschlossen haben, um Experience Platform-Endpunkte erfolgreich aufrufen zu können. Durch Abschluss des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Kopfzeilen in Experience Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Alle Anfragen mit einer Payload im Anfragetext (wie POST-, PUT- und PATCH-Aufrufe) müssen eine Content-Type-Kopfzeile enthalten. Akzeptierte Werte, die für jeden Aufruf spezifisch sind, werden in den Aufrufparametern angegeben.
Alle Ressourcen in Experience Platform sind auf bestimmte virtuelle Sandboxes beschränkt. Anfragen an Experience Platform-APIs erfordern eine Kopfzeile, die den Namen der Sandbox angibt, in der der Vorgang ausgeführt werden soll:
x-sandbox-name: {SANDBOX_NAME}
Weitere Informationen zu Sandboxes in Experience Platform finden Sie in der Sandbox-Übersichtsdokumentation.