TOPIX REST-Schnittstelle

TOPIX mit Ihren Anwendungen verbinden

Ob KI-Tool, Webshop, Versanddienstleister, Zahlungsdienst, Kundenportal oder eigene App: Wenn Informationen automatisiert zwischen TOPIX und einem anderen System ausgetauscht werden sollen, schafft die REST-Schnittstelle die Verbindung. Anfragen gehen über die Schnittstelle an das andere System; Antworten kommen auf demselben Weg zurück. Die Daten fließen in Echtzeit, manuelle Übertragungen entfallen.

Daten aus zentralen TOPIX-Bereichen nutzen

Die TOPIX REST-Schnitttelle greift auf Daten aus verschiedenen Bereichen zu. Dazu gehören Adressen, Tickets, Projekte, Aufträge, Artikel, Dokumente, Termine, Finanzen und der Personalbereich. Welche Aktionen eine angebundene Anwendung ausführen darf, legen Sie über die Berechtigungen fest: Daten lesen, neue Daten anlegen, bestehende Daten ändern oder Daten löschen. Der mögliche Zugriff ist dabei abgestuft: Lesende Zugriffe sind umfangreicher als Schreibzugriffe; Löschzugriffe sind nochmals stärker begrenzt. So lässt sich der Datenaustausch an den benötigten Aufgaben ausrichten.

So läuft der Datenaustausch ab

Möchten Sie beispielsweise mit einem KI-Tool wissen, welche Tickets bei einem Kunden offen sind, wird die Frage zunächst an eine technische Vermittlungsschicht übergeben. Das kann ein REST-/OpenAPI-Connector oder ein MCP-Server sein. Diese Vermittlung übersetzt die Frage in einen Aufruf an die TOPIX REST-Schnittstelle. TOPIX prüft Mandant, Identität und Zugriffsrechte und sucht anschließend die passenden Kundendaten und offenen Tickets. Das Ergebnis wird über denselben Weg zurückgegeben; das KI-Tool formuliert daraus die Antwort.

Ihre Daten bleiben unter Ihrer Kontrolle

Kein externes System und keine KI greift direkt auf die TOPIX-Datenbank zu. Der einzige Datenweg führt über die TOPIX REST-Schnittstelle, die jede Anfrage prüft. Was nicht erlaubt ist, bleibt für andere Systeme unerreichbar – und es werden nur Informationen ausgegeben, die in TOPIX über Benutzerrechte und Zugriffe freigegeben sind. Der Zugriff erfolgt im Kontext eines TOPIX Benutzers. Dafür können Sie entweder die Rechte eines bestehenden TOPIX Benutzers verwenden oder einen eigenen, eingeschränkten REST-Benutzer einrichten. Auch ein Administratorzugang ist technisch möglich; für gezielte Begrenzungen lässt sich ein eigener REST-Benutzer mit den benötigten Rechten verwenden.

Häufig gestellte Fragen zu REST-Schnittstellen

Hier beantworten wir einige der häufigsten Fragen, die zur TOPIX REST-Schnittstelle bestehen. Diese Antworten sollen Ihnen helfen, die Vorteile und Einsatzmöglichkeiten einer solchen Schnittstelle besser zu verstehen. Möchten Sie ein besseres Verständnis – speziell für die TOPIX REST-Schnittstelle – bekommen? Dann zögern Sie nicht, uns zu kontaktieren.

Was ist die TOPIX REST-Schnittstelle?

Die TOPIX REST-Schnittstelle ist eine Kommunikationsbrücke zwischen TOPIX und anderen Programmen. Anfragen und Antworten werden über die Schnittstelle ausgetauscht, sodass Daten in Echtzeit fließen können.

Welche Systeme lassen sich anbinden?

Prinzipiell unendlich viele Systeme, wie KI-Tools, Webshops, Versanddienstleister, Zahlungsdienste, Kundenportale oder eigene Apps.

Auf welche TOPIX-Daten kann eine Anbindung zugreifen?

Auf Adressen, Tickets, Projekte, Aufträge, Artikel, Dokumente, Termine, Finanzen und der Personalbereich. Welche Daten und Aktionen verfügbar sind, hängt von den eingerichteten Berechtigungen ab.

Kann eine angebundene Anwendung TOPIX-Daten verändern oder löschen?

Sie legen fest, ob die Anbindung Daten nur lesen, neue Daten anlegen, vorhandene Daten ändern oder Daten löschen darf. Die möglichen Zugriffe sind abgestuft: Schreibzugriffe sind stärker begrenzt als Lesezugriffe, Löschzugriffe nochmals stärker.

Greift ein KI-Tool direkt auf die TOPIX-Datenbank zu?

Nein. Externe Systeme und KI-Tools greifen nicht direkt auf die TOPIX-Datenbank zu. Anfragen laufen über die REST-Schnittstelle, wo Mandant, Identität und Rechte geprüft werden. Ausgegeben werden nur freigegebene Informationen.

Wie wird der Zugriff auf die REST-Schnittstelle gesteuert?

Der Zugriff erfolgt mit den Rechten eines TOPIX Benutzers oder über einen eigens eingerichteten, eingeschränkten REST-Benutzer. Die Benutzerrechte bestimmen, welche Informationen und Aktionen freigegeben sind.

Wie wird eine Frage aus einem KI-Tool an TOPIX übermittelt?

Ein REST-/OpenAPI-Connector oder MCP-Server kann die Frage in einen Aufruf an die TOPIX REST-Schnittstelle übersetzen. TOPIX prüft den Zugriff, ermittelt die passenden Daten und gibt das Ergebnis über denselben Weg zurück.