Für Entwickler
Eine API, die man auch von außen benutzen kann.
REST unter /api/v2, Authentifizierung per widerrufbarem Token, und ein Anschluss für KI-Assistenten, die direkt mit den Daten arbeiten.
Was zur Verfügung steht
REST-API v2
Geräte, Kunden, Kalibrierungen, Aufträge, Dokumente und mehr, als JSON über HTTPS.
Token-Verwaltung
Token je Benutzer anlegen, benennen, befristen und einzeln widerrufen. Rotation stört andere Integrationen nicht.
Least-Privilege-Rolle
Eine mitgelieferte Rolle für Anfrage-Portale, die nur das darf, was ein Portal braucht.
KI-Anbindung per MCP
Ein Anschluss, über den KI-Assistenten Tabellen lesen und pflegen können, mit denselben Rechten wie ein Benutzer.
Auftragsanbindung
Ein dokumentierter Vertrag für Anfrage-Portale: Anfrage anlegen, Status abfragen, Belege abholen.
Belegkanal für Kunden
Ein eigener Endpunkt liefert nur freigegebene Dokumente in der letzten Version, interne Entwürfe bleiben drin.
Grenzen, die Sie vorher kennen sollten
calServer sendet keine Webhooks. Wer auf Änderungen reagieren will, fragt den Stand ab. Für Portale hat sich ein Abstand von etwa 15 Minuten bewährt. Push in Richtung Drittsystem ist geplant, aber heute nicht vorhanden, und wir schreiben es lieber hier hin als in die Projektbesprechung.
Die Schnittstellenbeschreibung ist noch nicht für jeden Endpunkt vollständig. Was dokumentiert ist, finden Sie in der öffentlichen Dokumentation; für alles andere fragen Sie einfach nach, dann bekommen Sie eine belastbare Auskunft statt einer Vermutung.