Zum Inhalt springen

Version 1.0.0 · So funktioniert Hera

Hera REST-API

Schnittstelle je Mandant. Anmeldung mit API-Schlüssel im Kopf „Authorization: Bearer hk_…“ (Schlüssel und Rechte legt die Leitung unter Einstellungen, Schnittstellen an; gespeichert wird nur ein Hash). Antworten in JSON, Zeiten in UTC nach ISO 8601, Fehler als {"fehler": "<code>"}. Jede Antwort trägt „API-Version“ und „X-Hera-Umgebung“ (produktiv oder sandbox). Abgekündigte Endpunkte senden „Deprecation“, „Sunset“ und einen Link auf den Nachfolger.

Basisadresse
https://cockpit.kritera.de/api/v1
OpenAPI 3.1
openapi.json

Einstieg

Anmeldung und Rechte

Jede Anfrage trägt einen API-Schlüssel des Mandanten im Kopf „Authorization“. Die Leitung legt Schlüssel unter Einstellungen, Schnittstellen an; der Klartext erscheint nur einmal, gespeichert wird ein Hash. Ein Schlüssel kann ablaufen und jederzeit widerrufen werden.

curl -H "Authorization: Bearer hk_…" https://cockpit.kritera.de/api/v1/status
Rechterlaubt
lesenKontrollen, Kampagnen, Fälle, Bewertungen, Findings, Maßnahmen, Importe und Prüfobjekte lesen, Berichte und Kontrollakte abrufen
schreibenKampagnen starten, externe Kennung und Status von Findings und Maßnahmen setzen, Unzustellbarkeit melden
grundgesamtheitGrundgesamtheit liefern (Vorschau oder Übernahme)

Fehler und Grenzen

Fehler kommen als JSON mit einem maschinenlesbaren Code, zum Beispiel {"fehler": "nicht_gefunden"}. Objekte eines anderen Mandanten gelten als nicht vorhanden.

HTTPBedeutung
400Ungültige Anfrage
401Kein oder ungültiger API-Schlüssel
403Dem Schlüssel fehlt das Recht
404Nicht gefunden (auch: anderer Mandant)
409Konflikt mit dem Zustand
413Anfrage zu groß
422Inhaltlich ungültig
429Zu viele Anfragen (600 je zehn Minuten und Schlüssel; 30 Fehlversuche je fünf Minuten und Adresse)

Versionierung und Abkündigung

Die Hauptversion steht im Pfad (/api/v1). Innerhalb von v1 kommen nur rückwärtsverträgliche Änderungen hinzu: neue Endpunkte und neue Felder in Antworten. Werten Sie unbekannte Felder daher nicht als Fehler. Was wegfällt, wird mindestens sechs Monate vorher abgekündigt: Die Antworten tragen dann „Deprecation“ (RFC 9745), „Sunset“ (RFC 8594) und einen Link auf den Nachfolger, das API-Protokoll markiert solche Aufrufe. Nach dem Sunset-Datum antwortet der Endpunkt mit 410.

API-Version: 1.0.0
Deprecation: @1798761600
Sunset: Thu, 31 Dec 2026 23:00:00 GMT
Link: </api/v1/…>; rel="successor-version"

Sandbox

Ein Sandbox-Mandant verhält sich wie ein echter, aber Mails gehen nur ins Testpostfach und die KI antwortet mit festen Beispielantworten, ohne Kosten. Webhooks werden zugestellt. Jede Antwort zeigt die Umgebung im Kopf „X-Hera-Umgebung“. Den Sandbox-Mandanten richtet der Betrieb auf Anfrage ein.

Allgemein

GET /status

Verbindung, Umgebung und Rechte des Schlüssels prüfen. Jeder gültige Schlüssel, unabhängig von seinen Rechten.

jeder gültige Schlüssel · Antwort 200 · Fehler 401, 429

Antwort (Beispiel)

{
  "api": "Text",
  "version": "Text",
  "mandant": "Text",
  "umgebung": "produktiv",
  "schluessel": {
    "name": "Text",
    "rechte": [
      "lesen"
    ]
  },
  "zeit": "2026-10-26T09:30:00+00:00"
}

GET /openapi.json

Diese Beschreibung (OpenAPI 3.1).

ohne Schlüssel · Antwort 200

POST /mail/bounces

Unzustellbarkeit einer Einladung melden.

Recht: schreiben · Antwort 200 · Fehler 400, 401, 403, 404, 429

Anfrage (Beispiel)

{
  "message_id": "Text",
  "empfaenger": "Text",
  "art": "hart",
  "grund": "Text"
}

Antwort (Beispiel)

{
  "treffer": 1
}

Grundgesamtheit

POST /populations

Grundgesamtheit liefern (Vorschau oder Übernahme). Standardattribute wie in der Oberfläche, weitere unter „attribute“. Bis 20.000 Prüfobjekte und 30 MB.

Recht: grundgesamtheit · Antwort 201 · Fehler 400, 401, 403, 413, 422, 429

Anfrage (Beispiel)

{
  "objekte": [
    {
      "kennung": "Text",
      "name": "Text",
      "status": "Text",
      "typ": "Text",
      "bcm_relevant": "Text",
      "kritikalitaet": "Text",
      "schutzbedarf": "Text",
      "bereich": "Text",
      "betreiber": "Text",
      "owner": "Text",
      "manager": "Text",
      "email": "Text",
      "fuehrungskraft": "Text",
      "fuehrungskraft_email": "Text",
      "attribute": {}
    }
  ],
  "vollstaendig": true,
  "modus": "vorschau"
}

Antwort (Beispiel)

{
  "import_id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "status": "vorschau",
  "zeilen": 1,
  "objekte": 1,
  "neu": 1,
  "geaendert": 1,
  "entfallen": 1,
  "klaerung": [
    {
      "zeile": 1,
      "art": "Text",
      "wert": "Text"
    }
  ],
  "vorschau_url": "https://…"
}

GET /populations

Letzte 50 Importe.

Recht: lesen · Antwort 200 · Fehler 401, 403, 429

Antwort (Beispiel)

{
  "importe": [
    {
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "quelle": "datei",
      "status": "vorschau",
      "zeilen": 1,
      "neu": 1,
      "geaendert": 1,
      "entfallen": 1,
      "erstellt_am": "2026-10-26T09:30:00+00:00",
      "uebernommen_am": "2026-10-26T09:30:00+00:00"
    }
  ]
}

GET /populations/{iid}

Ein Import.

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 429

ParameterOrtTyp
iid *path string (uuid) · Import

Antwort (Beispiel)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "quelle": "datei",
  "status": "vorschau",
  "zeilen": 1,
  "neu": 1,
  "geaendert": 1,
  "entfallen": 1,
  "erstellt_am": "2026-10-26T09:30:00+00:00",
  "uebernommen_am": "2026-10-26T09:30:00+00:00"
}

GET /assets

Prüfobjekte des Bestands.

Recht: lesen · Antwort 200 · Fehler 401, 403, 429

ParameterOrtTyp
limitquery integer
offsetquery integer
aktivquery string: true, false

Antwort (Beispiel)

{
  "gesamt": 1,
  "limit": 1,
  "offset": 1,
  "objekte": [
    {
      "kennung": "Text",
      "name": "Text",
      "status": "Text",
      "typ": "Text",
      "bcm_relevant": "Text",
      "kritikalitaet": "Text",
      "schutzbedarf": "Text",
      "bereich": "Text",
      "betreiber": "Text",
      "owner": "Text",
      "manager": "Text",
      "email": "Text",
      "fuehrungskraft": "Text",
      "fuehrungskraft_email": "Text",
      "attribute": {},
      "aktiv": true,
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f"
    }
  ]
}

Kontrollen und Kampagnen

GET /kontrollen

Kontrollen lesen.

Recht: lesen · Antwort 200 · Fehler 401, 403, 429

Antwort (Beispiel)

{
  "kontrollen": [
    {
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "titel": "Text",
      "status": "Text",
      "vorlage": {
        "kennung": "Text",
        "version": 1
      }
    }
  ]
}

GET /kampagnen

Kampagnen lesen.

Recht: lesen · Antwort 200 · Fehler 400, 401, 403, 429

ParameterOrtTyp
limitquery integer
offsetquery integer
statusquery string: entwurf, laeuft, abgeschlossen, abgebrochen
kontrollequery string (uuid)

Antwort (Beispiel)

{
  "kampagnen": [
    {
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "titel": "Text",
      "status": "entwurf",
      "kontrolle": {
        "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
        "titel": "Text"
      },
      "auswahl": "voll",
      "auswahl_fest": true,
      "pruefzeitraum_von": "2026-10-26",
      "pruefzeitraum_bis": "2026-10-26",
      "start_am": "2026-10-26",
      "frist_am": "2026-10-26",
      "nachfrist_am": "2026-10-26",
      "ende_am": "2026-10-26",
      "abgeschlossen_am": "2026-10-26T09:30:00+00:00",
      "faelle": 1
    }
  ],
  "gesamt": 1,
  "limit": 1,
  "offset": 1
}

GET /kampagnen/{cid}

Kampagne mit Ablauf und Ergebnissen.

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 429

ParameterOrtTyp
cid *path string (uuid) · Kampagne

Antwort (Beispiel)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "titel": "Text",
  "status": "entwurf",
  "kontrolle": {
    "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "titel": "Text"
  },
  "auswahl": "voll",
  "auswahl_fest": true,
  "pruefzeitraum_von": "2026-10-26",
  "pruefzeitraum_bis": "2026-10-26",
  "start_am": "2026-10-26",
  "frist_am": "2026-10-26",
  "nachfrist_am": "2026-10-26",
  "ende_am": "2026-10-26",
  "abgeschlossen_am": "2026-10-26T09:30:00+00:00",
  "faelle": 1,
  "trichter": {
    "eingeladen": 1,
    "geoeffnet": 1,
    "eingereicht": 1,
    "ki_geprueft": 1,
    "bewertet": 1,
    "abgeschlossen": 1,
    "faelle": 1
  },
  "ergebnisse": {
    "erfuellt": 1,
    "teilweise": 1,
    "nicht_erfuellt": 1,
    "nicht_relevant": 1,
    "offen": 1
  },
  "protokoll_hash": "Text"
}

POST /kampagnen/{cid}/start

Kampagne starten. Nur mit festgeschriebener Auswahl und gültigen Mailadressen. 409 nennt die Hindernisse.

Recht: schreiben · Antwort 200 · Fehler 400, 401, 403, 404, 409, 429

ParameterOrtTyp
cid *path string (uuid) · Kampagne

Anfrage (Beispiel)

{
  "versandweg": "plattform",
  "sprache": "de"
}

Antwort (Beispiel)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "titel": "Text",
  "status": "entwurf",
  "kontrolle": {
    "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "titel": "Text"
  },
  "auswahl": "voll",
  "auswahl_fest": true,
  "pruefzeitraum_von": "2026-10-26",
  "pruefzeitraum_bis": "2026-10-26",
  "start_am": "2026-10-26",
  "frist_am": "2026-10-26",
  "nachfrist_am": "2026-10-26",
  "ende_am": "2026-10-26",
  "abgeschlossen_am": "2026-10-26T09:30:00+00:00",
  "faelle": 1
}

Fälle und Bewertungen

GET /kampagnen/{cid}/faelle

Fälle einer Kampagne mit Status, KI-Vorschlag und Bewertung.

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 429

ParameterOrtTyp
cid *path string (uuid) · Kampagne
limitquery integer
offsetquery integer
statusquery string

Antwort (Beispiel)

{
  "faelle": [
    {
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "nr": 1,
      "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "kennung": "Text",
      "name": "Text",
      "status": "Text",
      "stufe": 1,
      "frist_am": "2026-10-26",
      "eingeladen_am": "2026-10-26T09:30:00+00:00",
      "eingereicht_am": "2026-10-26T09:30:00+00:00",
      "einreicher": {
        "name": "Text",
        "email": "Text"
      },
      "ki": {
        "stand": "laeuft",
        "gesamt": "Text",
        "fertig_am": "2026-10-26T09:30:00+00:00"
      },
      "bewertung": {
        "status": "Text",
        "gesamt": "erfuellt",
        "schweregrad": "niedrig",
        "fassung": 1,
        "bewertet_am": "2026-10-26T09:30:00+00:00"
      },
      "findings": [
        "F-0001"
      ]
    }
  ],
  "gesamt": 1,
  "limit": 1,
  "offset": 1
}

GET /faelle/{fid}

Fall mit Dateien (nur Angaben), Nachweisen, Rückfragen und Bewertungen.

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 429

ParameterOrtTyp
fid *path string (uuid) · Fall

Antwort (Beispiel)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "nr": 1,
  "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "kennung": "Text",
  "name": "Text",
  "status": "Text",
  "stufe": 1,
  "frist_am": "2026-10-26",
  "eingeladen_am": "2026-10-26T09:30:00+00:00",
  "eingereicht_am": "2026-10-26T09:30:00+00:00",
  "einreicher": {
    "name": "Text",
    "email": "Text"
  },
  "ki": {
    "stand": "laeuft",
    "gesamt": "Text",
    "fertig_am": "2026-10-26T09:30:00+00:00"
  },
  "bewertung": {
    "status": "Text",
    "gesamt": "erfuellt",
    "schweregrad": "niedrig",
    "fassung": 1,
    "bewertet_am": "2026-10-26T09:30:00+00:00"
  },
  "findings": [
    "F-0001"
  ],
  "dateien": [
    {
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "anforderung": "Text",
      "name": "Text",
      "groesse": 1,
      "sha256": "Text",
      "status": "Text",
      "scan": "Text",
      "erstellt_am": "2026-10-26T09:30:00+00:00"
    }
  ],
  "nachweise": [
    {
      "anforderung": "Text",
      "art": "verweis",
      "erstellt_am": "2026-10-26T09:30:00+00:00",
      "zurueckgezogen_am": "2026-10-26T09:30:00+00:00"
    }
  ],
  "rueckfragen": [
    {
      "kriterium": "Text",
      "status": "Text",
      "frist_am": "2026-10-26",
      "erstellt_am": "2026-10-26T09:30:00+00:00"
    }
  ],
  "bewertungen": [
    {
      "fassung": 1,
      "status": "entwurf",
      "gesamt": "erfuellt",
      "schweregrad": "niedrig",
      "abweichungsart": "Text",
      "begruendung": "Text",
      "schnell": true,
      "kriterien": [
        {
          "key": "Text",
          "ergebnis": "Text",
          "begruendung": "Text",
          "quelle": "Text"
        }
      ],
      "bewertet_von": "Text",
      "bewertet_am": "2026-10-26T09:30:00+00:00",
      "freigegeben_von": "Text",
      "freigegeben_am": "2026-10-26T09:30:00+00:00"
    }
  ]
}

GET /faelle/{fid}/bewertungen

Alle Fassungen der Bewertung eines Falls.

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 429

ParameterOrtTyp
fid *path string (uuid) · Fall

Antwort (Beispiel)

{
  "bewertungen": [
    {
      "fassung": 1,
      "status": "entwurf",
      "gesamt": "erfuellt",
      "schweregrad": "niedrig",
      "abweichungsart": "Text",
      "begruendung": "Text",
      "schnell": true,
      "kriterien": [
        {
          "key": "Text",
          "ergebnis": "Text",
          "begruendung": "Text",
          "quelle": "Text"
        }
      ],
      "bewertet_von": "Text",
      "bewertet_am": "2026-10-26T09:30:00+00:00",
      "freigegeben_von": "Text",
      "freigegeben_am": "2026-10-26T09:30:00+00:00"
    }
  ]
}

Findings und Maßnahmen

GET /findings

Findings mit Maßnahmen.

Recht: lesen · Antwort 200 · Fehler 401, 403, 429

Antwort (Beispiel)

{
  "findings": [
    {
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "kennung": "F-0001",
      "titel": "Text",
      "schweregrad": "niedrig",
      "status": "offen",
      "externe_kennung": "Text",
      "objekt": "Text",
      "kampagne": "Text",
      "fall": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "beschreibung": "Text",
      "auswirkung": "Text",
      "erstellt_am": "2026-10-26T09:30:00+00:00",
      "massnahmen": [
        {
          "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
          "finding": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
          "status": "offen",
          "frist": "2026-10-26",
          "externe_kennung": "Text",
          "verantwortlich": "Text"
        }
      ]
    }
  ]
}

PATCH /findings/{xid}

Externe Kennung oder Status eines Findings setzen.

Recht: schreiben · Antwort 200 · Fehler 401, 403, 404, 422, 429

ParameterOrtTyp
xid *path string (uuid) · Finding

Anfrage (Beispiel)

{
  "externe_kennung": "Text",
  "status": "offen",
  "grund": "Text"
}

Antwort (Beispiel)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "kennung": "F-0001",
  "titel": "Text",
  "schweregrad": "niedrig",
  "status": "offen",
  "externe_kennung": "Text",
  "objekt": "Text",
  "kampagne": "Text",
  "fall": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f"
}

GET /massnahmen

Maßnahmen.

Recht: lesen · Antwort 200 · Fehler 401, 403, 429

Antwort (Beispiel)

{
  "massnahmen": [
    {
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "finding": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "status": "offen",
      "frist": "2026-10-26",
      "externe_kennung": "Text",
      "verantwortlich": "Text",
      "beschreibung": "Text"
    }
  ]
}

PATCH /massnahmen/{mid}

Externe Kennung oder Status einer Maßnahme setzen.

Recht: schreiben · Antwort 200 · Fehler 401, 403, 404, 422, 429

ParameterOrtTyp
mid *path string (uuid) · Maßnahme

Anfrage (Beispiel)

{
  "externe_kennung": "Text",
  "status": "geschlossen",
  "kommentar": "Text"
}

Antwort (Beispiel)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "finding": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "status": "offen",
  "frist": "2026-10-26",
  "externe_kennung": "Text",
  "verantwortlich": "Text"
}

Berichte und Kontrollakte

GET /kampagnen/{cid}/berichte

Freigegebene Kontrollberichte einer Kampagne.

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 429

ParameterOrtTyp
cid *path string (uuid) · Kampagne

Antwort (Beispiel)

{
  "berichte": [
    {
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "fassung": 1,
      "status": "freigegeben",
      "hash": "Text",
      "pdf_sha256": "Text",
      "docx_sha256": "Text",
      "freigegeben_am": "2026-10-26T09:30:00+00:00"
    }
  ]
}

GET /berichte/{bid}

Angaben zu einem freigegebenen Bericht mit Hash.

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 429

ParameterOrtTyp
bid *path string (uuid) · Bericht

Antwort (Beispiel)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "fassung": 1,
  "status": "freigegeben",
  "hash": "Text",
  "pdf_sha256": "Text",
  "docx_sha256": "Text",
  "freigegeben_am": "2026-10-26T09:30:00+00:00"
}

GET /berichte/{bid}.{endung}

Bericht als PDF oder DOCX (geprüft gegen die Prüfsumme).

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 409, 429

ParameterOrtTyp
bid *path string (uuid) · Bericht
endung *path string: pdf, docx

POST /kampagnen/{cid}/akte

Kontrollakte als ZIP anfordern (Hintergrundauftrag).

Recht: lesen · Antwort 202 · Fehler 401, 403, 404, 409, 429

ParameterOrtTyp
cid *path string (uuid) · Kampagne

Antwort (Beispiel)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "status": "offen",
  "groesse": 1,
  "sha256": "Text",
  "dateien": 1,
  "erstellt_am": "2026-10-26T09:30:00+00:00",
  "ablauf_am": "2026-10-26T09:30:00+00:00"
}

GET /akten/{aid}

Stand einer Kontrollakte.

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 429

ParameterOrtTyp
aid *path string (uuid) · Kontrollakte

Antwort (Beispiel)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "status": "offen",
  "groesse": 1,
  "sha256": "Text",
  "dateien": 1,
  "erstellt_am": "2026-10-26T09:30:00+00:00",
  "ablauf_am": "2026-10-26T09:30:00+00:00"
}

GET /akten/{aid}.zip

Kontrollakte herunterladen (sieben Tage).

Recht: lesen · Antwort 200 · Fehler 401, 403, 404, 429

ParameterOrtTyp
aid *path string (uuid) · Kontrollakte

Webhooks

Webhooks richtet die Leitung unter Einstellungen, Webhooks ein. Jede Nachricht ist ein POST mit JSON ohne Dokumentinhalte. Die Signatur im Kopf „X-Hera-Signatur“ ist HMAC-SHA256 über „<X-Hera-Zeit>.<Körper>“ mit dem Geheimnis des Webhooks. Antwortet Ihr Dienst nicht mit 2xx, wird nach 1, 5 und 30 Minuten sowie nach 2 und 12 Stunden wiederholt, danach aufgegeben; alle Versuche stehen im Webhook-Protokoll. „X-Hera-Zustellung“ ist je Nachricht eindeutig und hilft gegen doppelte Verarbeitung.

import hashlib, hmac, time

def pruefen(geheimnis: str, kopf: dict, koerper: bytes) -> bool:
    zeit = kopf["X-Hera-Zeit"]
    if abs(time.time() - int(zeit)) > 300:
        return False
    soll = "sha256=" + hmac.new(geheimnis.encode(), zeit.encode() + b"." + koerper, hashlib.sha256).hexdigest()
    return hmac.compare_digest(soll, kopf["X-Hera-Signatur"])

POST case.submitted

Einreichung abgeschlossen

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "ereignis": "case.submitted",
  "zeit": "2026-10-26T09:30:00+00:00",
  "mandant": "Text",
  "daten": {
    "fall": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "objekt": "Text",
    "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "status": "Text"
  }
}

POST case.escalated

Fall eskaliert (Stufe 2)

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "ereignis": "case.escalated",
  "zeit": "2026-10-26T09:30:00+00:00",
  "mandant": "Text",
  "daten": {
    "fall": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "objekt": "Text",
    "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "stufe": 1
  }
}

POST case.reviewed

Bewertung abgeschlossen

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "ereignis": "case.reviewed",
  "zeit": "2026-10-26T09:30:00+00:00",
  "mandant": "Text",
  "daten": {
    "fall": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "objekt": "Text",
    "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "ergebnis": "erfuellt",
    "schweregrad": "Text",
    "fassung": 1
  }
}

POST finding.created

Finding angelegt

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "ereignis": "finding.created",
  "zeit": "2026-10-26T09:30:00+00:00",
  "mandant": "Text",
  "daten": {
    "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "kennung": "F-0001",
    "titel": "Text",
    "schweregrad": "niedrig",
    "status": "offen",
    "externe_kennung": "Text",
    "objekt": "Text",
    "kampagne": "Text",
    "fall": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f"
  }
}

POST measure.updated

Maßnahme geändert

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "ereignis": "measure.updated",
  "zeit": "2026-10-26T09:30:00+00:00",
  "mandant": "Text",
  "daten": {
    "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "finding": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "status": "offen",
    "frist": "2026-10-26",
    "externe_kennung": "Text",
    "verantwortlich": "Text"
  }
}

POST campaign.closed

Kampagne abgeschlossen

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "ereignis": "campaign.closed",
  "zeit": "2026-10-26T09:30:00+00:00",
  "mandant": "Text",
  "daten": {
    "kampagne": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "titel": "Text",
    "kontrolle": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
    "faelle": 1,
    "ergebnisse": {},
    "findings": 1,
    "bericht": {
      "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
      "fassung": 1,
      "hash": "Text"
    }
  }
}