Was ist meine Organisation?
Eine Organisation ist eine Adobe-Darstellung einer Kundin oder eines Kunden. Alle lizenzierten Adobe-Lösungen sind in diese Kundenorganisation integriert. Wenn eine Organisation über eine Berechtigung für Experience Platform verfügt, kann sie Entwicklerinnen und Entwicklern Zugriff zuweisen. Die Organisations-ID (x-gw-ims-org-id) stellt die Organisation dar, für die ein API-Aufruf ausgeführt werden soll, und ist daher in allen API-Anfragen als Kopfzeile obligatorisch. Diese ID können Sie unter Verwendung der Adobe Developer Console suchen: Navigieren Sie auf der Registerkarte Integrationen zum Abschnitt Übersicht einer bestimmten Integration, um unter Client-Anmeldedaten die ID anzuzeigen. Eine schrittweise Anleitung zum Authentifizieren bei Experience Platform finden Sie im Authentifizierungs-Tutorial.
Wo finde ich meinen API-Schlüssel?
In allen API-Anfragen ist ein API-Schlüssel als Kopfzeile erforderlich. Sie können ihn über die Adobe Developer Console finden. Navigieren Sie in der Konsole auf der Registerkarte Integrationen zum Abschnitt Übersicht einer bestimmten Integration; Sie finden den Schlüssel dann unter Client-Anmeldedaten. Eine schrittweise Anleitung zum Authentifizieren bei Experience Platform finden Sie im Authentifizierungs-Tutorial.
Woher bekomme ich ein Zugriffs-Token?
Zugriffstoken sind in der Autorisierungskopfzeile aller API-Aufrufe erforderlich. Sie können mit einem CURL-Befehl generiert werden, vorausgesetzt, Sie haben Zugriff auf eine Integration für eine Organisation. Zugriffstoken sind nur 24 Stunden lang gültig. Danach muss ein neues Token generiert werden, wenn Sie die API weiter verwenden möchten. Weiterführende Informationen zum Generieren von Zugriffstoken finden Sie im Authentifizierungs-Tutorial.
Wie verwende ich Abfrageparameter?
Einige Experience Platform-API-Endpunkte akzeptieren Abfrageparameter, damit Sie nach bestimmten Informationen suchen und die in der Antwort zurückgegebenen Ergebnisse filtern können. Abfrageparameter werden mit einem Fragezeichen (?) an Anfragepfade angehängt, gefolgt von einem oder mehreren Abfrageparametern im Format paramName=paramValue. Wenn Sie mehrere Parameter in einem einzelnen Aufruf nutzen möchten, müssen Sie ein kaufmännisches Und-Zeichen (&) verwenden, um einzelne Parameter voneinander zu trennen. Das folgende Beispiel zeigt, wie eine Anfrage, bei der mehrere Abfrageparameter zum Einsatz kommen, in der Dokumentation dargestellt wird.
Beispiele für häufig verwendete Abfrageparameter sind:
GET /tenant/schemas?orderby=title
GET /datasets?limit=36&start=10
GET /batches?createdAfter=1559775880000&orderBy=desc:created
Detaillierte Informationen dazu, welche Abfragen bei einem bestimmten Service oder Endpunkt verfügbar sind, finden Sie in der dienstspezifischen Dokumentation.
Wie gebe ich ein JSON-Feld an, das in einer PATCH-Anfrage aktualisiert werden soll?
Viele PATCH-Vorgänge in Experience Platform-APIs verwenden JSON-Zeiger-Zeichenfolgen, um anzugeben, welche JSON-Eigenschaften aktualisiert werden sollen. Diese werden normalerweise im JSON Patch-Format in Anfrage-Payloads eingebunden. Weiterführende Informationen zur für diese Technologien erforderlichen Syntax finden Sie im API-Grundlagenhandbuch.
Kann ich Postman nutzen, um Aufrufe an Experience Platform-APIs auszuführen?
Postman ist ein hilfreiches Tool zur Visualisierung von Aufrufen an RESTful-APIs. Das Handbuch zu den ersten Schritten mit der Experience PlatformAPI enthält ein Video und Anweisungen zum Importieren von Postman-Sammlungen. Darüber hinaus wird eine Liste mit Postman-Sammlungen für jeden Service bereitgestellt.
Welche Systemanforderungen gelten für Experience Platform?
Je nachdem, ob Sie die Benutzeroberfläche oder API verwenden, gelten die folgenden Systemanforderungen:
Für UI-basierte Vorgänge:
- Ein moderner, standardmäßiger Webbrowser. Zwar wird die neueste Version von Chrome empfohlen, doch werden auch aktuelle und frühere Hauptversionen von Firefox, Internet Explorer und Safari unterstützt.
- Bei jeder Veröffentlichung einer neuen Hauptversion beginnt Experience Platform mit der Unterstützung der neuesten Version, während die Unterstützung für die drittneueste Version eingestellt wird.
- Bei allen Browsern müssen Cookies und JavaScript aktiviert sein.
Für Interaktionen mit APIs und Entwicklern:
- Eine Entwicklungsumgebung für die Entwicklung von REST-, Streaming- und Webhook-Integrationen.
Fehler und Fehlerbehebung
Im Folgenden finden Sie eine Liste mit Fehlern, die bei der Verwendung von Experience Platform-Services auftreten können. Hinweise zur Fehlerbehebung bei einzelnen Experience Platform-Services finden Sie unten im Verzeichnis zur Fehlerbehebung bei Services.