QUANTICAL.ERP Docs
Administration

API-Schlüssel

API-Schlüssel in QUANTICAL.ERP für Automatisierungen wie n8n anlegen - Berechtigungen je Endpunkt, Ablauf und Nutzungslimit, Authentifizierung per x-api-key und die Endpunkte der Automation-API.

Mit einem API-Schlüssel lesen externe Werkzeuge Daten aus QUANTICAL.ERP, ohne dass sich jemand einloggt: ein Wochenbericht in n8n, eine Auswertung in Excel, ein Abgleich mit der Lohnbuchhaltung. Die Schlüssel verwalten Sie unter Administration > API-Schlüssel.

Liste der API-Schlüssel mit Vorschau, Status, Berechtigungen, Ablauf und Erstellungsdatum

Schlüssel anlegen

API-Schlüssel erstellen öffnet den Dialog. Der Name sagt später, wofür der Schlüssel ist, das Präfix macht ihn im Log erkennbar. Läuft ab in begrenzt die Lebensdauer von 30 Tagen bis zu einem Jahr oder nie. Maximale Nutzungen deaktiviert den Schlüssel nach einer festen Zahl von Aufrufen. Unter Endpunkt-Berechtigungen wählen Sie, welche Daten der Schlüssel lesen darf, Alle Endpunkte oder einzelne.

Dialog Neuen API-Schlüssel erstellen mit Name, Präfix, Ablauf, Nutzungen und Berechtigungen

Schlüssel kopieren

Nach dem Erstellen zeigt QUANTICAL.ERP den Schlüssel genau einmal. Kopieren Sie ihn jetzt in Ihr Werkzeug, danach ist nur noch die Schlüsselvorschau sichtbar. Geht er verloren, legen Sie einen neuen an und löschen den alten.

Dialog API-Schlüssel erstellt mit dem einmalig sichtbaren Schlüssel

Schlüssel verwenden

Jede Anfrage trägt den Schlüssel im Header x-api-key. Die eingebaute Dokumentation beschreibt die Endpunkte mit Parametern, Beispielaufrufen und Antworten und lässt sich Als Markdown kopieren, etwa um sie einem Entwickler oder einem KI-Assistenten zu geben.

EndpunktLiefert
/api/automationStatus des Schlüssels
/api/automation/weekly-booking-reportGebuchte und fehlende Stunden aller aktiven Mitarbeiter je Kalenderwoche
/api/automation/time-entriesZeiteinträge, filterbar nach Projekt, Mitarbeiter, Kunde und Zeitraum
/api/automation/projectsProjekte, auf Wunsch mit Besetzung und Stundensätzen
/api/automation/employeesMitarbeiterstammdaten ohne sensible Felder
/api/automation/vacation-requestsUrlaubsanträge jeden Status

Automation-API-Dokumentation mit Authentifizierung und dem Endpunkt Status

Ein Schlüssel liest mit den Rechten eines Eigentümers. Geben Sie je Werkzeug einen eigenen Schlüssel mit nur den nötigen Berechtigungen heraus und löschen Sie ihn, sobald das Werkzeug ihn nicht mehr braucht.