Firmen-API: DASon mit Ihrer Software und KI verbinden
Die Firmen-API verbindet DASon mit Ihrer eigenen Software. Termine, Teilnehmer, Personen und Zertifikate tauschen Sie automatisch aus, statt sie doppelt zu pflegen. Eine fertige Beschreibung für KI-Assistenten gehört dazu.
Wofür
- Personen aus Ihrer Personal- oder Kundenverwaltung übernehmen und aktuell halten
- Schulungstermine und Teilnehmer aus Ihrem Buchungs- oder Kalendersystem anlegen
- Teilnahme-Ergebnisse eintragen, damit Zertifikate automatisch entstehen
- Zertifikate und PDFs abrufen, zum Beispiel für Ihr Intranet oder Ihre Personalakte
- Ablaufende Zertifikate abfragen und rechtzeitig Nachschulungen planen
- Zertifikate auf Echtheit prüfen, auch aus Ihrer eigenen Anwendung heraus
Für wen
Für Schulungsanbieter, Prüfstellen und Betriebe, die bereits mit eigener Software, Tabellen-Automatisierungen oder KI-Assistenten arbeiten und DASon daran anbinden möchten. Für die Einrichtung reicht eine Person, die Ihre Software oder Automatisierung betreut.
So geht’s
- Buchen Sie unter „Abo & Nutzung“ die Zusatzoption „Firmen-API“.
- Öffnen Sie im Menü „Firma“ den Punkt „API“ und wählen Sie, was der Schlüssel darf: „Lesen“, „Schreiben“ und „Prüfen“.
- Erzeugen Sie den Schlüssel und hinterlegen Sie ihn in Ihrer Software. Er wird nur einmal vollständig angezeigt.
- Geben Sie Ihrer Software die maschinenlesbare Beschreibung (OpenAPI 3.1) oder Ihrem KI-Assistenten die Anleitung als Markdown-Datei. Beide finden Sie auf derselben Seite.
- Unter „Protokoll“ sehen Sie jeden Aufruf mit Zeit, Pfad und Status.
Das ist enthalten
- Lesen: Schulungen, Termine, Teilnehmer, Personen, Zertifikate, ablaufende Zertifikate und Zertifikat-PDFs
- Schreiben: Personen anlegen oder aktualisieren, Termine anlegen und ändern, Teilnehmer eintragen, Teilnahme-Status setzen, Fremdzertifikate als PDF hochladen
- Prüfen: Zertifikate über Nummer, Name und Geburtsdatum oder über den Prüfwert aus dem Hash-Archiv prüfen
- Offene Beschreibung nach OpenAPI 3.1 und eine Anleitung für KI-Assistenten, beide ohne Anmeldung abrufbar
- Protokoll der letzten Aufrufe ohne Inhalte und ohne IP-Adressen
Gut zu wissen
Der Schlüssel gilt nur für Ihre Firma. Jeder Aufruf sieht ausschließlich deren Daten, wie in der Oberfläche. Es gibt je Firma einen aktiven Schlüssel. Ein neuer Schlüssel oder ein Widerruf sperrt den alten sofort. Lesende Aufrufe sind auf 120 pro Minute begrenzt, schreibende auf 30 pro Minute und 500 pro Tag. Aufrufe über die API verbrauchen Ihr Paket wie die Arbeit in der Oberfläche. Ein KI-Assistent arbeitet mit dem Schlüssel nur so weit, wie Sie ihm Rechte geben. Vergeben Sie deshalb nur den Umfang, den er braucht. Preise siehe Preisseite.
Häufige Fragen
Brauche ich Programmierkenntnisse?
Für die Anbindung an eine eigene Software ja, oder jemanden, der sie betreut. Werkzeuge und KI-Assistenten, die eine OpenAPI-Beschreibung lesen können, richten viele Aufrufe aber fast von selbst ein. Die mitgelieferte Anleitung für KI-Assistenten erklärt Anmeldung, Abläufe und Fehlercodes.
Kann ein KI-Assistent damit Zertifikate ausstellen?
Ein Assistent mit dem Umfang „Schreiben“ kann Termine und Teilnehmer anlegen und den Teilnahme-Status setzen. Zertifikate entstehen dann nach denselben Regeln wie in der Oberfläche, etwa erst ab dem Schulungstag und nur für verknüpfte Personen.
Sind meine Daten über die API sicher?
DASon speichert den Schlüssel nur als Prüfwert (Hash), nie im Klartext. Er gilt nur für Ihre Firma. Jeder Aufruf wird protokolliert. Den Schlüssel können Sie jederzeit widerrufen. Ohne angenommenen Auftragsverarbeitungsvertrag lässt sich kein Schlüssel erzeugen.
Kann ich die API vor dem Buchen ansehen?
Ja. Die vollständige Beschreibung aller Endpunkte ist öffentlich abrufbar und enthält keine Daten. Sie können sie Ihrem Dienstleister oder Ihrem KI-Assistenten vorab geben.