Reactor-API-Handbuch

Die Reactor-API bietet mehrere Endpunkte, mit denen Sie alle Ressourcen für Tags in Adobe Experience Platform programmgesteuert verwalten können.

Diese Endpunkte werden nachfolgend beschrieben. Weitere Informationen zur Authentifizierung bei der API finden Sie in den Handbüchern zu den einzelnen Endpunkten und im Erste Schritte-Handbuch.

Um alle verfügbaren Endpunkte und CRUD-Vorgänge anzuzeigen, konsultieren Sie die Reactor API-Referenz.

Firmen

Ein Unternehmen stellt die Organisation eines Tags-Benutzers dar, normalerweise eine Firma. Diese Unternehmen stimmen 1:1 mit Organisations-IDs überein. API-Benutzer haben nur Einblick in die Unternehmen, auf die sie Zugriff haben.

Informationen zum Anzeigen verfügbarer Unternehmen in der API finden Sie im Handbuch zum companies-Endpunkt.

Eigenschaften

Eine Eigenschaft ist ein Container, der die meisten anderen Ressourcen enthält, die in der Reactor-API verfügbar sind. Die einzigen Ressourcen, die keiner Eigenschaft gehören, sind Audit-Ereignisse, Unternehmen, Erweiterungspakete und Profile. Eine Eigenschaft gehört zu genau einem Unternehmen und ein Unternehmen kann über viele Eigenschaften verfügen.

Informationen zum Verwalten von Eigenschaften in der API finden Sie im Handbuch zum properties-Endpunkt.

Datenelemente

Ein Datenelement fungiert als Variable, die auf wichtige Daten innerhalb Ihres Programms verweist. Datenelemente werden in Regeln und Erweiterungskonfigurationen verwendet. Wenn die Regel zur Laufzeit in einem Browser oder einem Programm ausgelöst wird, wird der Wert des Datenelements aufgelöst und innerhalb der Regel verwendet.

Informationen zum Verwalten von Datenelementen in der API finden Sie im Handbuch zu data elements-Endpunkt.

Regeln

Regeln steuern das Verhalten der Ressourcen, die in einer bereitgestellten Bibliothek enthalten sind. Eine Regel ist eine Gruppe aus einer oder mehreren Regelkomponenten, die dazu dient, die Regelkomponenten logisch miteinander zu verbinden.

Informationen zum Verwalten von Regeln in der API finden Sie im Handbuch zum rules-Endpunkt.

Regelkomponenten

Regelkomponenten sind die einzelnen Elemente, aus denen eine Regel besteht. Regelkomponenten haben drei grundlegende Typen:

Informationen zum Verwalten von Regeln in der API finden Sie im Handbuch zum rules-Endpunkt.

Erweiterungspakete

Ein Erweiterungspaket stellt eine Gruppierung einzelner Funktionen dar, die einem Tag-Benutzer zur Verfügung gestellt werden können. Diese Funktionen werden meist in Form von Regelkomponenten und Datenelementen bereitgestellt, können aber auch Hauptmodule und gemeinsame Module enthalten. Die von einem Erweiterungspaket bereitgestellten Funktionen werden als Erweiterung installiert, wenn es in einer Bibliothek enthalten ist.

Informationen zum Verwalten von Erweiterungspaketen in der API finden Sie im Handbuch zum extension packages-Endpunkt.

Erweiterungen

Eine Erweiterung stellt die installierte Instanz eines Erweiterungspakets dar. Eine Erweiterung stellt die durch ein Erweiterungspaket definierten Funktionen für eine Eigenschaft zur Verfügung. Diese Funktionen werden beim Erstellen von Datenelementen und Regelkomponenten genutzt.

Informationen zum Verwalten von Erweiterungen in der API finden Sie im Handbuch zum extensions-Endpunkt.

Bibliotheken

Eine Bibliothek ist eine Sammlung von Ressourcen (Erweiterungen, Regeln und Datenelemente), die das gewünschte Verhalten einer Eigenschaft darstellen. Bibliotheken werden in Builds kompiliert und diese Builds werden verschiedenen Umgebungen zugewiesen, während sie sich im Veröffentlichungsablauf von Tests zur Produktion bewegen.

Informationen zum Verwalten von Bibliotheken in der API finden Sie im Handbuch zum libraries-Endpunkt.

Builds

Eine Tag-Bibliothek wird in einen Build kompiliert, damit sie einer Umgebung zum Testen und zur Bereitstellung zugewiesen werden kann. Der Inhalt eines Builds variiert je nach den in der Bibliothek enthaltenen Ressourcen, der Konfiguration der Umgebung, der der Build zugewiesen ist, und der Plattform der Eigenschaft, zu der der Build gehört.

Informationen zum Verwalten von Builds in der API finden Sie im Handbuch zum builds-Endpunkt.

Umgebungen

Eine Umgebung gibt den spezifischen Host an, auf dem ein Build bereitgestellt werden kann, und ob der Build als Dateisatz bereitgestellt oder in einem Archivformat komprimiert werden soll. In der Reactor-API sind Umgebungen getrennt von den Hosts selbst, die vom /hosts-Endpunkt verwaltet werden.

Informationen zum Verwalten von Builds in der API finden Sie im Handbuch zum builds-Endpunkt.

Hosts

Ein Host stellt ein gehostetes Ziel dar, in dem ein Bibliotheks-Build bereitgestellt und letztendlich implementiert werden kann. Hosts können entweder Akamai- oder SFTP-Server sein.

Informationen zum Verwalten von Hosts in der API finden Sie im Handbuch zum hosts-Endpunkt.

Programmkonfigurationen

App-Konfigurationen ermöglichen das Speichern und Abrufen von Anmeldeinformationen zur späteren Verwendung. Informationen zum Verwalten von App-Konfigurationen in der API finden Sie im Handbuch zum app configurations-Endpunkt.

Audit-Ereignisse

Ein Prüfereignis ist ein Datensatz einer bestimmten Änderung an einer anderen Tag-Ressource, der zum Zeitpunkt der Änderung generiert wird. Dies sind Systemereignisse, die über eine Callback-Funktion abonniert werden können.

Informationen zum Verwalten von Audit-Ereignissen in der API finden Sie im Handbuch zum audit events-Endpunkt.

Callbacks

Ein Callback ist eine Nachricht, die Platform bei der Erstellung eines neuen Audit-Ereignisses an einen URL-Host sendet. Informationen zum Verwalten von Callbacks in der API finden Sie im Handbuch zum callbacks-Endpunkt.

Anmerkungen

Anmerkungen sind Kommentare in Textform, die Sie bestimmten Tag-Ressourcen hinzufügen können, z. B. Datenelementen, Erweiterungen, Bibliotheken, Eigenschaften, Regeln und Regelkomponenten. Informationen zum Verwalten von Notizen in der API finden Sie im Handbuch zum notes-Endpunkt.

Profil

Ein Profil enthält alle Informationen zum angemeldeten Benutzer, einschließlich aller Adobe-Organisationen, denen er angehört, der Produktprofile, denen er in jeder Organisation angehört, und der Rechte, die ihm aus jedem Produktprofil zugewiesen sind.

Weitere Informationen zum Anzeigen dieser Informationen in der API finden Sie im Handbuch zum profile-Endpunkt.

Durchsuchen

Der /search-Endpunkt bietet eine Möglichkeit, Ressourcen zu finden, die den gewünschten Kriterien entsprechen und als Abfrage ausgedrückt werden. Alle Abfragen beziehen sich auf Ihr aktuelles Unternehmen und auf verfügbare Eigenschaften. Weitere Informationen zur Verwendung dieser Funktion finden Sie im Handbuch zum search-Endpunkt.

Geheime Daten

Geheime Daten enthalten Anmeldeinformationen, mit denen sich die Ereignisweiterleitung für einen sicheren Datenaustausch bei einem anderen System authentifizieren kann. Im Handbuch zu geheimen Daten finden Sie einen Überblick darüber, wie geheime Daten in der Ereignisweiterleitung funktionieren. Zudem erhalten Sie im Endpunktleitfaden für geheime Daten weitere Informationen darüber, wie Sie geheime Daten in der Reactor-API verwalten.

Nächste Schritte

Um mit der Durchführung von Aufrufen mit der Schema Registry API zu beginnen, lesen Sie das Erste-Schritte-Handbuch und wählen Sie dann eines der Endpunkt-Handbücher aus, um zu erfahren, wie Sie bestimmte Endpunkte verwenden.