Inhaltstyp-Kopfzeile
Alle Anfragen mit einer Payload im Anfragetext (wie POST-, PUT- und PATCH-Aufrufe) müssen eine Content-Type
-Kopfzeile enthalten. Akzeptierte Werte sind für jeden API-Endpunkt spezifisch. Wenn ein bestimmter Content-Type
für einen Endpunkt benötigt wird, wird sein Wert in den Beispiel-API-Anfragen angezeigt, die von den API-Handbüchern für einzelne Experience Platform-Services)werden.
Experience Platform API-Grundlagen
Adobe Experience Platform-APIs verwenden verschiedene zugrunde liegende Technologien und Syntaxen, die für das effektive Verwalten von Experience Platform-Ressourcen wichtig sind.
Weitere Informationen zu den zugrunde liegenden API-Technologien, die Experience Platform verwendet, einschließlich Beispiel-JSON-Schemaobjekten, finden Sie im Handbuch Grundlagen der Experience Platform-API.
Postman-Sammlungen für Experience Platform-APIs
Postman ist eine Kollaborationsplattform für die API-Entwicklung, mit der Sie Umgebungen mit voreingestellten Variablen einrichten, API-Sammlungen freigeben, CRUD-Anfragen optimieren und vieles mehr. Die meisten Experience Platform-API-Services verfügen über Postman-Sammlungen, die Sie bei API-Aufrufen unterstützen können.
Weitere Informationen zu Postman, einschließlich der Einrichtung einer Umgebung, einer Liste der verfügbaren Sammlungen und des Imports von Sammlungen, finden Sie in der Dokumentation zu Experience Platform Postman.
Lesen von Beispiel-API-Aufrufen
Anfrageformate variieren je nach der verwendeten Experience Platform-API. Am einfachsten erfahren Sie, wie Sie API-Aufrufe strukturieren können, indem Sie sich die in der Dokumentation für einzelne Experience Platform-Services angegebenen Beispiele ansehen.
Die Dokumentation für Experience Platform zeigt Beispiel-API-Aufrufe auf zwei verschiedene Arten. Zunächst wird der Aufruf im API-Format dargestellt, wobei es sich um eine Vorlagendarstellung handelt, die nur den Vorgang (GET, POST, PUT, PATCH, DELETE) und den verwendeten Endpunkt (z. B. /global/classes
) zeigt. Manche Vorlagen zeigen auch die Stelle von Variablen an, um zu veranschaulichen, wie ein Aufruf formuliert werden sollte, z. B. GET /{VARIABLE}/classes/{ANOTHER_VARIABLE}
.
Die Aufrufe werden dann als cURL-Befehle in einer Anfrage angezeigt, die die erforderlichen Kopfzeilen und den vollständigen „Basispfad“ enthält, die für eine erfolgreiche Interaktion mit der API erforderlich sind. Der Basispfad sollte allen Endpunkten vorangestellt werden. Der oben genannte Endpunkt /global/classes
beispielsweise ändert sich in https://platform.adobe.io/data/foundation/schemaregistry/global/classes
. In der gesamten Dokumentation wird das API-Format-/Anfragemuster angezeigt. Es wird erwartet, dass Sie den vollständigen Pfad verwenden, der in der Beispielanfrage angezeigt wird, wenn Sie Ihre eigenen Aufrufe an Experience Platform-APIs durchführen.