Zurück zum Hilfecenter

Schnittstelle: Rezepte

Rezept: Qualifikationsnachweise aus dem Personalsystem einspielen

Unterweisungen und Fachkunden automatisch übernehmen und fortschreiben.

Für wen

IT, Personalabteilung und Fachkraft für Arbeitssicherheit.

Voraussetzungen

Schlüssel mit `qualifications:read` und `qualifications:write`

Schritt für Schritt

  1. 1

    Bestand abgleichen

    Zunächst die vorhandenen Nachweise lesen und über Person, Titel und Ausstellungsdatum zuordnen.

    curl
    curl -sS "https://api.elyph.io/v1/qualifications?status=valid&limit=200" \
  -H "Authorization: Bearer $ELYPH_API_KEY"
  2. 2

    Neue Nachweise anlegen

    Für jede neue Unterweisung einen Nachweis senden. Ohne Konto in elyph genügt der Name der Person.

    curl
    curl -sS "https://api.elyph.io/v1/qualifications" \
  -H "Authorization: Bearer $ELYPH_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
  "person_name": "Jens Roth",
  "title": "Unterweisung Gabelstapler",
  "kind": "unterweisung",
  "issuer": "Werksicherheit",
  "issued_at": "2026-09-01",
  "valid_until": "2027-08-31"
}'
  3. 3

    Ablauf überwachen

    Mit `expires_before` holen Sie alle Nachweise, die demnächst auslaufen, und erinnern rechtzeitig.

    curl
    curl -sS "https://api.elyph.io/v1/qualifications?expires_before=2026-06-30&limit=200" \
  -H "Authorization: Bearer $ELYPH_API_KEY"
  4. 4

    Datensparsam bleiben

    Übertragen Sie nur, was für den Nachweis nötig ist: Person, Art, Titel, Aussteller und Fristen — keine Personalnummern oder Gesundheitsdaten.

API-Konsole

Anfrage zusammenstellen, Code kopieren und — angemeldet und mit eigenem Schlüssel — wirklich ausführen. Die Konsole führt ausschließlich lesende Aufrufe aus.

GET https://api.elyph.io/v1/qualifications?limit=10

Statuswert exakt wie im Feld `status`.

Nur Nachweise, deren Gültigkeit bis zu diesem Datum endet.

Nur Objekte, die seit diesem Zeitpunkt geändert wurden (ISO 8601). Grundlage jeder Synchronisation.

Anzahl der Objekte je Seite, 1 bis 200. Standard 50.

Fortsetzungsmarke aus `page.next` der vorherigen Antwort. Keine Seitenzahl.

curl
curl -sS "https://api.elyph.io/v1/qualifications?limit=10" \
  -H "Authorization: Bearer $ELYPH_API_KEY"

Echttest

Nach der Anmeldung führen Sie dieselbe Anfrage hier mit Ihrem eigenen Schlüssel aus. So sieht eine echte Antwort aus:

Beispielantwort
{
  "data": [
    {
      "id": "b21f0f6a-8f52-4f7c-9f0e-3b9b0f21a4c8",
      "title": "Unterweisung Gabelstapler",
      "kind": "unterweisung",
      "group_code": "FLURFOERDER",
      "person": {
        "name": "Jens Roth",
        "email": "jens.roth@example.com"
      },
      "issuer": "Werksicherheit",
      "certificate_number": "UW-2025-0442",
      "legal_basis": "DGUV Vorschrift 68",
      "issued_at": "2025-09-01",
      "valid_until": "2026-08-31",
      "update_due_at": "2026-08-01",
      "status": "valid",
      "updated_at": "2025-09-01T12:00:00Z"
    }
  ],
  "page": {
    "next": null,
    "limit": 10
  },
  "rate": {
    "limit": 120,
    "remaining": 118,
    "reset_at": "2026-02-01T10:31:00Z"
  }
}

Ergebnis

Unterweisungsnachweise sind in elyph vollständig, aktuell und fristgerecht überwacht.

Häufige Stolpersteine

  • Bei jedem Lauf alle Nachweise neu anlegen: Vergleichen Sie zuerst mit dem Bestand.
  • Gesundheitsbezogene Vorsorgedaten übertragen: Sie gehören nicht in die Schnittstelle.

Hintergrund

Nachweise sind personenbezogene Daten. Die Übertragung braucht eine Rechtsgrundlage und sollte im Verarbeitungsverzeichnis stehen; das Nutzungsprotokoll der Schnittstelle dient als Nachweis.

Verwandte Artikel