API und Schnittstellen

Führerscheinkontrolle in Ihre Systeme integrieren

Personen aus Ihrer HR-, Mitglieder- oder Fuhrparksoftware automatisch anlegen und aktuell halten, Führerscheinstatus und Fälligkeiten abrufen. REST-API mit JSON, API-Schlüssel je Organisation, OpenAPI-3-Spezifikation.

Personen anlegen

POST /persons legt an oder aktualisiert per Personalnummer. Ideal für den nächtlichen Abgleich mit Ihrem Personalsystem.

Personen bearbeiten

PATCH /persons/{id} ändert nur die übergebenen Felder, etwa E-Mail oder Personalnummer. DELETE entfernt Ausgeschiedene.

Status abrufen

GET /persons?status=abgelaufen listet, GET /persons/staff/{nr} liefert eine einzelne Person per Personalnummer: Gültigkeit, Klassen, nächste Prüfung, Quelle (Wallet oder manuell).

So geht es los: Organisation registrieren, unter Einstellungen → API-Schnittstelle einen Schlüssel erzeugen, Anfragen mit Authorization: Bearer fsk_… senden. Im Testbetrieb kostenlos.

Beispiele

# Person anlegen (oder per Personalnummer aktualisieren)
curl -X POST https://die-fuehrerscheinkontrolle.de/wp-json/fsk/v1/persons \
  -H "Authorization: Bearer fsk_IHR_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"given_name":"Erika","family_name":"Mustermann","birth_date":"1964-08-12","email":"erika@example.org","staff_no":"1001"}'

# Alle Personen mit abgelaufenem Führerschein
curl https://die-fuehrerscheinkontrolle.de/wp-json/fsk/v1/persons?status=abgelaufen -H "Authorization: Bearer fsk_IHR_SCHLUESSEL"

# E-Mail ändern und Einladung senden
curl -X PATCH https://die-fuehrerscheinkontrolle.de/wp-json/fsk/v1/persons/42 -H "Authorization: Bearer fsk_IHR_SCHLUESSEL" -H "Content-Type: application/json" -d '{"email":"neu@example.org"}'
curl -X POST https://die-fuehrerscheinkontrolle.de/wp-json/fsk/v1/persons/42/invite -H "Authorization: Bearer fsk_IHR_SCHLUESSEL"

Referenz (OpenAPI)

Spezifikation: openapi.json · zum Import in Postman, Insomnia oder Code-Generatoren.