Skip to main content
Über die REST-API lesen und schreiben Ihre eigenen Systeme Daten in ibana, etwa Stammdaten aus Ihrer Buchhaltungssoftware oder Bestellungen aus Ihrem Warenwirtschaftssystem. Alle Endpunkte mit Parametern und Antworten stehen in der API Reference.

API-Schlüssel erstellen

API-Schlüssel verwalten Admins unter Einstellungen → API & MCP im Abschnitt API-Schlüssel.
  1. Klicken Sie auf Neuen Schlüssel erstellen.
  2. Klicken Sie im Dialog auf API-Schlüssel erstellen.
  3. Kopieren Sie den Schlüssel mit Kopieren und legen Sie ihn sicher ab. ibana zeigt ihn nur dieses eine Mal an.
Die Liste zeigt danach für jeden Schlüssel die Schlüssel-ID (über das Augen-Symbol einblendbar) und wer ihn erstellt hat.
  • Ein Schlüssel pro Person: Jede Person hat in einer Organisation höchstens einen Schlüssel. Erstellen Sie einen neuen, ersetzt er Ihren bisherigen; Anfragen mit dem alten Schlüssel lehnt ibana ab.
  • Schlüssel löschen: Löschen neben dem Schlüssel. Anfragen mit diesem Schlüssel lehnt ibana ab sofort ab.
Ein API-Schlüssel greift auf die Daten der gesamten Organisation zu, unabhängig von der Rolle und den Berechtigungen der Person, die ihn erstellt hat. Behandeln Sie ihn wie ein Passwort und löschen Sie Schlüssel, die nicht mehr gebraucht werden.

Einstellungen → API & MCP

Der Tab bündelt die beiden Zugänge von außen: API-Schlüssel für Systeme, die die REST-API aufrufen, und den Schalter für KI-Clients, die sich per MCP mit dem persönlichen Login verbinden. Nur Admins sehen den Tab.

Anfragen senden

Was die API abdeckt

API oder MCP

Die REST-API ist für Systeme gedacht, die ohne Person laufen. Wer ibana aus einem KI-Client wie Claude oder ChatGPT nutzen will, verbindet sich über MCP mit dem eigenen Login; dort gelten die persönlichen Berechtigungen, und API-Schlüssel werden nicht verwendet.