Firmen-API und API-Schlüssel

Mit der Firmen-API verbinden Sie Ihre eigene Software oder einen KI-Assistenten mit DASon: Schulungen, Termine, Personen und Zertifikate lesen, anlegen oder prüfen.

1. Öffnen Sie im Menü Firma den Punkt API. Die Seite sehen Firmen-Administratoren.
2. Wählen Sie unter Umfang des neuen Schlüssels, was der Schlüssel darf: Lesen, Schreiben und Prüfen. Voreingestellt ist Lesen.
3. Wählen Sie Schlüssel erzeugen und bestätigen Sie. Kopieren Sie den Schlüssel mit Kopieren und speichern Sie ihn sicher. Er wird nur dieses eine Mal vollständig angezeigt.
4. Die Karte API-Beschreibung nennt Basis-URL, Anmeldung per Bearer-Token, alle Endpunkte, Fehlercodes und Grenzen. Über openapi.json öffnen erhalten Sie die maschinenlesbare Beschreibung, über Anleitung für Ihre KI (Markdown) eine Datei für Ihren KI-Assistenten.
5. Unter Protokoll sehen Sie die letzten 50 Aufrufe mit Zeit, Methode, Pfad und Status.
6. Mit Neu erzeugen ersetzen Sie den Schlüssel, mit Widerrufen sperren Sie ihn. In beiden Fällen ist der bisherige Schlüssel sofort ungültig.

Je Firma gibt es einen aktiven Schlüssel, er gilt nur für diese Firma. Die Firmen-API ist eine Zusatzoption, die Sie unter Abo & Nutzung buchen. Vorher muss der AVV angenommen sein. Das Protokoll speichert keine Inhalte und keine IP-Adressen und wird nach 180 Tagen gelöscht.