{"components":{"responses":{"F400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}},"description":"Ung\u00fcltige Anfrage"},"F401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}},"description":"Kein oder ung\u00fcltiger API-Schl\u00fcssel"},"F403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}},"description":"Dem Schl\u00fcssel fehlt das Recht"},"F404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}},"description":"Nicht gefunden (auch: anderer Mandant)"},"F409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}},"description":"Konflikt mit dem Zustand"},"F413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}},"description":"Anfrage zu gro\u00df"},"F422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}},"description":"Inhaltlich ung\u00fcltig"},"F429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}},"description":"Zu viele Anfragen (600 je zehn Minuten und Schl\u00fcssel; 30 Fehlversuche je f\u00fcnf Minuten und Adresse)"}},"schemas":{"Akte":{"additionalProperties":false,"properties":{"ablauf_am":{"format":"date-time","type":["string","null"]},"dateien":{"type":"integer"},"erstellt_am":{"format":"date-time","type":"string"},"groesse":{"type":["integer","null"]},"id":{"format":"uuid","type":"string"},"kampagne":{"format":"uuid","type":"string"},"sha256":{"type":["string","null"]},"status":{"enum":["offen","laeuft","fertig","fehler","abgelaufen"],"type":"string"}},"required":["id","kampagne","status","groesse","sha256","dateien","erstellt_am","ablauf_am"],"type":"object"},"Bericht":{"additionalProperties":false,"properties":{"docx_sha256":{"type":"string"},"fassung":{"type":"integer"},"freigegeben_am":{"format":"date-time","type":"string"},"hash":{"description":"SHA-256 \u00fcber das eingefrorene Abbild","type":"string"},"id":{"format":"uuid","type":"string"},"kampagne":{"format":"uuid","type":"string"},"pdf_sha256":{"type":"string"},"status":{"enum":["freigegeben","ersetzt"],"type":"string"}},"required":["id","kampagne","fassung","status","hash","pdf_sha256","docx_sha256","freigegeben_am"],"type":"object"},"Berichte":{"additionalProperties":false,"properties":{"berichte":{"items":{"$ref":"#/components/schemas/Bericht"},"type":"array"}},"required":["berichte"],"type":"object"},"Bewertung":{"additionalProperties":false,"properties":{"abweichungsart":{"type":"string"},"begruendung":{"type":"string"},"bewertet_am":{"format":"date-time","type":["string","null"]},"bewertet_von":{"type":["string","null"]},"fassung":{"type":"integer"},"freigegeben_am":{"format":"date-time","type":["string","null"]},"freigegeben_von":{"type":["string","null"]},"gesamt":{"enum":["erfuellt","teilweise","nicht_erfuellt","nicht_relevant",null],"type":["string","null"]},"kriterien":{"items":{"additionalProperties":false,"properties":{"begruendung":{"type":"string"},"ergebnis":{"type":["string","null"]},"key":{"type":["string","null"]},"quelle":{"type":"string"}},"required":["key","ergebnis","begruendung","quelle"],"type":"object"},"type":"array"},"schnell":{"type":"boolean"},"schweregrad":{"enum":["niedrig","mittel","hoch","sehr_hoch",null],"type":["string","null"]},"status":{"enum":["entwurf","zur_freigabe","abgeschlossen","ersetzt"],"type":"string"}},"required":["fassung","status","gesamt","schweregrad","abweichungsart","begruendung","schnell","kriterien","bewertet_von","bewertet_am","freigegeben_von","freigegeben_am"],"type":"object"},"Bewertungen":{"additionalProperties":false,"properties":{"bewertungen":{"items":{"$ref":"#/components/schemas/Bewertung"},"type":"array"}},"required":["bewertungen"],"type":"object"},"Bounce":{"additionalProperties":false,"description":"message_id oder empfaenger ist Pflicht","properties":{"art":{"default":"hart","enum":["hart","weich"],"type":"string"},"empfaenger":{"type":"string"},"grund":{"type":"string"},"message_id":{"type":"string"}},"required":[],"type":"object"},"BounceErgebnis":{"additionalProperties":false,"properties":{"treffer":{"type":"integer"}},"required":["treffer"],"type":"object"},"Ereignis":{"additionalProperties":false,"description":"H\u00fclle jeder Webhook-Nachricht. Nie mit Dokumentinhalten.","properties":{"daten":{"type":"object"},"ereignis":{"enum":["case.submitted","case.escalated","case.reviewed","finding.created","measure.updated","campaign.closed"],"type":"string"},"id":{"format":"uuid","type":"string"},"mandant":{"type":"string"},"zeit":{"format":"date-time","type":"string"}},"required":["id","ereignis","zeit","mandant","daten"],"type":"object"},"Faelle":{"additionalProperties":false,"properties":{"faelle":{"items":{"$ref":"#/components/schemas/Fall"},"type":"array"},"gesamt":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["faelle","gesamt","limit","offset"],"type":"object"},"Fall":{"additionalProperties":false,"properties":{"bewertung":{"additionalProperties":false,"properties":{"bewertet_am":{"format":"date-time","type":["string","null"]},"fassung":{"type":"integer"},"gesamt":{"enum":["erfuellt","teilweise","nicht_erfuellt","nicht_relevant",null],"type":["string","null"]},"schweregrad":{"enum":["niedrig","mittel","hoch","sehr_hoch",null],"type":["string","null"]},"status":{"type":"string"}},"required":["status","gesamt","schweregrad","fassung","bewertet_am"],"type":["object","null"]},"eingeladen_am":{"format":"date-time","type":["string","null"]},"eingereicht_am":{"format":"date-time","type":["string","null"]},"einreicher":{"additionalProperties":false,"properties":{"email":{"type":"string"},"name":{"type":"string"}},"required":["name","email"],"type":"object"},"findings":{"items":{"pattern":"^F-[0-9]{4,}$","type":"string"},"type":"array"},"frist_am":{"format":"date","type":["string","null"]},"id":{"format":"uuid","type":"string"},"kampagne":{"format":"uuid","type":"string"},"kennung":{"type":["string","null"]},"ki":{"additionalProperties":false,"properties":{"fertig_am":{"format":"date-time","type":["string","null"]},"gesamt":{"type":["string","null"]},"stand":{"enum":["laeuft","fertig","fehler"],"type":"string"}},"required":["stand","gesamt","fertig_am"],"type":["object","null"]},"name":{"type":["string","null"]},"nr":{"type":"integer"},"status":{"type":"string"},"stufe":{"type":"integer"}},"required":["id","nr","kampagne","kennung","name","status","stufe","frist_am","eingeladen_am","eingereicht_am","einreicher","ki","bewertung","findings"],"type":"object"},"FallDetail":{"additionalProperties":false,"properties":{"bewertung":{"additionalProperties":false,"properties":{"bewertet_am":{"format":"date-time","type":["string","null"]},"fassung":{"type":"integer"},"gesamt":{"enum":["erfuellt","teilweise","nicht_erfuellt","nicht_relevant",null],"type":["string","null"]},"schweregrad":{"enum":["niedrig","mittel","hoch","sehr_hoch",null],"type":["string","null"]},"status":{"type":"string"}},"required":["status","gesamt","schweregrad","fassung","bewertet_am"],"type":["object","null"]},"bewertungen":{"items":{"$ref":"#/components/schemas/Bewertung"},"type":"array"},"dateien":{"items":{"additionalProperties":false,"properties":{"anforderung":{"type":"string"},"erstellt_am":{"format":"date-time","type":"string"},"groesse":{"type":"integer"},"id":{"format":"uuid","type":"string"},"name":{"type":"string"},"scan":{"type":"string"},"sha256":{"type":"string"},"status":{"type":"string"}},"required":["id","anforderung","name","groesse","sha256","status","scan","erstellt_am"],"type":"object"},"type":"array"},"eingeladen_am":{"format":"date-time","type":["string","null"]},"eingereicht_am":{"format":"date-time","type":["string","null"]},"einreicher":{"additionalProperties":false,"properties":{"email":{"type":"string"},"name":{"type":"string"}},"required":["name","email"],"type":"object"},"findings":{"items":{"pattern":"^F-[0-9]{4,}$","type":"string"},"type":"array"},"frist_am":{"format":"date","type":["string","null"]},"id":{"format":"uuid","type":"string"},"kampagne":{"format":"uuid","type":"string"},"kennung":{"type":["string","null"]},"ki":{"additionalProperties":false,"properties":{"fertig_am":{"format":"date-time","type":["string","null"]},"gesamt":{"type":["string","null"]},"stand":{"enum":["laeuft","fertig","fehler"],"type":"string"}},"required":["stand","gesamt","fertig_am"],"type":["object","null"]},"nachweise":{"items":{"additionalProperties":false,"properties":{"anforderung":{"type":"string"},"art":{"enum":["verweis","begruendung","alternative"],"type":"string"},"erstellt_am":{"format":"date-time","type":"string"},"zurueckgezogen_am":{"format":"date-time","type":["string","null"]}},"required":["anforderung","art","erstellt_am","zurueckgezogen_am"],"type":"object"},"type":"array"},"name":{"type":["string","null"]},"nr":{"type":"integer"},"rueckfragen":{"items":{"additionalProperties":false,"properties":{"erstellt_am":{"format":"date-time","type":"string"},"frist_am":{"format":"date","type":"string"},"kriterium":{"type":"string"},"status":{"type":"string"}},"required":["kriterium","status","frist_am","erstellt_am"],"type":"object"},"type":"array"},"status":{"type":"string"},"stufe":{"type":"integer"}},"required":["id","nr","kampagne","kennung","name","status","stufe","frist_am","eingeladen_am","eingereicht_am","einreicher","ki","bewertung","findings","dateien","nachweise","rueckfragen","bewertungen"],"type":"object"},"Fehler":{"additionalProperties":true,"description":"Maschinenlesbarer Fehlercode, eventuell mit Einzelheiten","properties":{"fehler":{"type":"string"}},"required":["fehler"],"type":"object"},"Finding":{"additionalProperties":false,"properties":{"auswirkung":{"type":"string"},"beschreibung":{"type":"string"},"erstellt_am":{"format":"date-time","type":"string"},"externe_kennung":{"type":["string","null"]},"fall":{"format":"uuid","type":"string"},"id":{"format":"uuid","type":"string"},"kampagne":{"type":["string","null"]},"kennung":{"pattern":"^F-[0-9]{4,}$","type":"string"},"massnahmen":{"items":{"$ref":"#/components/schemas/Massnahme"},"type":"array"},"objekt":{"type":["string","null"]},"schweregrad":{"enum":["niedrig","mittel","hoch","sehr_hoch"],"type":"string"},"status":{"enum":["offen","in_umsetzung","geschlossen","akzeptiert"],"type":"string"},"titel":{"type":"string"}},"required":["id","kennung","titel","schweregrad","status","externe_kennung","objekt","kampagne","fall","beschreibung","auswirkung","erstellt_am","massnahmen"],"type":"object"},"FindingAendern":{"additionalProperties":false,"properties":{"externe_kennung":{"maxLength":120,"type":["string","null"]},"grund":{"description":"Pflicht bei \u201eakzeptiert\u201c","type":"string"},"status":{"enum":["offen","in_umsetzung","geschlossen","akzeptiert"],"type":"string"}},"required":[],"type":"object"},"FindingKurz":{"additionalProperties":false,"properties":{"externe_kennung":{"type":["string","null"]},"fall":{"format":"uuid","type":"string"},"id":{"format":"uuid","type":"string"},"kampagne":{"type":["string","null"]},"kennung":{"pattern":"^F-[0-9]{4,}$","type":"string"},"objekt":{"type":["string","null"]},"schweregrad":{"enum":["niedrig","mittel","hoch","sehr_hoch"],"type":"string"},"status":{"enum":["offen","in_umsetzung","geschlossen","akzeptiert"],"type":"string"},"titel":{"type":"string"}},"required":["id","kennung","titel","schweregrad","status","externe_kennung","objekt","kampagne","fall"],"type":"object"},"Findings":{"additionalProperties":false,"properties":{"findings":{"items":{"$ref":"#/components/schemas/Finding"},"type":"array"}},"required":["findings"],"type":"object"},"Import":{"additionalProperties":false,"properties":{"entfallen":{"type":["integer","null"]},"erstellt_am":{"format":"date-time","type":"string"},"geaendert":{"type":["integer","null"]},"id":{"format":"uuid","type":"string"},"neu":{"type":["integer","null"]},"quelle":{"enum":["datei","api","push"],"type":"string"},"status":{"enum":["vorschau","uebernommen","verworfen"],"type":"string"},"uebernommen_am":{"format":"date-time","type":["string","null"]},"zeilen":{"type":"integer"}},"required":["id","quelle","status","zeilen","neu","geaendert","entfallen","erstellt_am","uebernommen_am"],"type":"object"},"Importe":{"additionalProperties":false,"properties":{"importe":{"items":{"$ref":"#/components/schemas/Import"},"type":"array"}},"required":["importe"],"type":"object"},"Kampagne":{"additionalProperties":false,"properties":{"abgeschlossen_am":{"format":"date-time","type":["string","null"]},"auswahl":{"enum":["voll","stichprobe"],"type":"string"},"auswahl_fest":{"type":"boolean"},"ende_am":{"format":"date","type":["string","null"]},"faelle":{"type":"integer"},"frist_am":{"format":"date","type":["string","null"]},"id":{"format":"uuid","type":"string"},"kontrolle":{"additionalProperties":false,"properties":{"id":{"format":"uuid","type":"string"},"titel":{"type":"string"}},"required":["id","titel"],"type":"object"},"nachfrist_am":{"format":"date","type":["string","null"]},"pruefzeitraum_bis":{"format":"date","type":["string","null"]},"pruefzeitraum_von":{"format":"date","type":["string","null"]},"start_am":{"format":"date","type":["string","null"]},"status":{"enum":["entwurf","laeuft","abgeschlossen","abgebrochen"],"type":"string"},"titel":{"type":"string"}},"required":["id","titel","status","kontrolle","auswahl","auswahl_fest","pruefzeitraum_von","pruefzeitraum_bis","start_am","frist_am","nachfrist_am","ende_am","abgeschlossen_am","faelle"],"type":"object"},"KampagneDetail":{"additionalProperties":false,"properties":{"abgeschlossen_am":{"format":"date-time","type":["string","null"]},"auswahl":{"enum":["voll","stichprobe"],"type":"string"},"auswahl_fest":{"type":"boolean"},"ende_am":{"format":"date","type":["string","null"]},"ergebnisse":{"additionalProperties":false,"properties":{"erfuellt":{"type":"integer"},"nicht_erfuellt":{"type":"integer"},"nicht_relevant":{"type":"integer"},"offen":{"type":"integer"},"teilweise":{"type":"integer"}},"required":["erfuellt","teilweise","nicht_erfuellt","nicht_relevant","offen"],"type":"object"},"faelle":{"type":"integer"},"frist_am":{"format":"date","type":["string","null"]},"id":{"format":"uuid","type":"string"},"kontrolle":{"additionalProperties":false,"properties":{"id":{"format":"uuid","type":"string"},"titel":{"type":"string"}},"required":["id","titel"],"type":"object"},"nachfrist_am":{"format":"date","type":["string","null"]},"protokoll_hash":{"type":["string","null"]},"pruefzeitraum_bis":{"format":"date","type":["string","null"]},"pruefzeitraum_von":{"format":"date","type":["string","null"]},"start_am":{"format":"date","type":["string","null"]},"status":{"enum":["entwurf","laeuft","abgeschlossen","abgebrochen"],"type":"string"},"titel":{"type":"string"},"trichter":{"additionalProperties":false,"properties":{"abgeschlossen":{"type":"integer"},"bewertet":{"type":"integer"},"eingeladen":{"type":"integer"},"eingereicht":{"type":"integer"},"faelle":{"type":"integer"},"geoeffnet":{"type":"integer"},"ki_geprueft":{"type":"integer"}},"required":["eingeladen","geoeffnet","eingereicht","ki_geprueft","bewertet","abgeschlossen","faelle"],"type":"object"}},"required":["id","titel","status","kontrolle","auswahl","auswahl_fest","pruefzeitraum_von","pruefzeitraum_bis","start_am","frist_am","nachfrist_am","ende_am","abgeschlossen_am","faelle","trichter","ergebnisse","protokoll_hash"],"type":"object"},"KampagneStarten":{"additionalProperties":false,"properties":{"sprache":{"default":"de","enum":["de","en"],"type":"string"},"versandweg":{"default":"plattform","description":"plattform: Einladungen per Mail; export: Links selbst verteilen","enum":["plattform","export"],"type":"string"}},"required":[],"type":"object"},"Kampagnen":{"additionalProperties":false,"properties":{"gesamt":{"type":"integer"},"kampagnen":{"items":{"$ref":"#/components/schemas/Kampagne"},"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["kampagnen","gesamt","limit","offset"],"type":"object"},"Kontrolle":{"additionalProperties":false,"properties":{"id":{"format":"uuid","type":"string"},"status":{"type":"string"},"titel":{"type":"string"},"vorlage":{"additionalProperties":false,"properties":{"kennung":{"type":"string"},"version":{"type":"integer"}},"required":["kennung","version"],"type":"object"}},"required":["id","titel","status","vorlage"],"type":"object"},"Kontrollen":{"additionalProperties":false,"properties":{"kontrollen":{"items":{"$ref":"#/components/schemas/Kontrolle"},"type":"array"}},"required":["kontrollen"],"type":"object"},"LieferErgebnis":{"additionalProperties":false,"properties":{"entfallen":{"type":"integer"},"geaendert":{"type":"integer"},"import_id":{"format":"uuid","type":"string"},"klaerung":{"items":{"additionalProperties":false,"properties":{"art":{"type":"string"},"wert":{"type":["string","null"]},"zeile":{"type":"integer"}},"required":["zeile","art","wert"],"type":"object"},"type":"array"},"neu":{"type":"integer"},"objekte":{"type":"integer"},"status":{"enum":["vorschau","uebernommen"],"type":"string"},"vorschau_url":{"format":"uri","type":"string"},"zeilen":{"type":"integer"}},"required":["import_id","status","zeilen","objekte","neu","geaendert","entfallen","klaerung","vorschau_url"],"type":"object"},"Liefern":{"additionalProperties":false,"properties":{"modus":{"default":"vorschau","enum":["vorschau","uebernehmen"],"type":"string"},"objekte":{"items":{"additionalProperties":false,"properties":{"attribute":{"additionalProperties":{"type":["string","number","boolean","null"]},"description":"Weitere Attribute (bis 50), Werte als Text, Zahl oder Wahrheitswert","type":"object"},"bcm_relevant":{"description":"BCM-relevant","type":["string","number","boolean","null"]},"bereich":{"description":"Bereich","type":["string","number","boolean","null"]},"betreiber":{"description":"Betreiber (intern/extern)","type":["string","number","boolean","null"]},"email":{"description":"E-Mail des Einreichers","type":["string","number","boolean","null"]},"fuehrungskraft":{"description":"F\u00fchrungskraft","type":["string","number","boolean","null"]},"fuehrungskraft_email":{"description":"E-Mail der F\u00fchrungskraft","type":["string","number","boolean","null"]},"kennung":{"description":"Kennung","type":["string","number","boolean","null"]},"kritikalitaet":{"description":"Kritikalit\u00e4t","type":["string","number","boolean","null"]},"manager":{"description":"Application Manager","type":["string","number","boolean","null"]},"name":{"description":"Name","type":["string","number","boolean","null"]},"owner":{"description":"Application Owner","type":["string","number","boolean","null"]},"schutzbedarf":{"description":"Schutzbedarf","type":["string","number","boolean","null"]},"status":{"description":"Status","type":["string","number","boolean","null"]},"typ":{"description":"Typ","type":["string","number","boolean","null"]}},"required":["kennung"],"type":"object"},"maxItems":20000,"minItems":1,"type":"array"},"vollstaendig":{"default":true,"description":"true: fehlende Pr\u00fcfobjekte gelten als entfallen","type":"boolean"}},"required":["objekte"],"type":"object"},"Massnahme":{"additionalProperties":false,"properties":{"externe_kennung":{"type":["string","null"]},"finding":{"format":"uuid","type":"string"},"frist":{"format":"date","type":"string"},"id":{"format":"uuid","type":"string"},"status":{"enum":["offen","in_umsetzung","nachweis_eingereicht","geschlossen","abgelehnt"],"type":"string"},"verantwortlich":{"type":"string"}},"required":["id","finding","status","frist","externe_kennung","verantwortlich"],"type":"object"},"MassnahmeAendern":{"additionalProperties":false,"properties":{"externe_kennung":{"maxLength":120,"type":["string","null"]},"kommentar":{"type":"string"},"status":{"enum":["geschlossen","abgelehnt","in_umsetzung"],"type":"string"}},"required":[],"type":"object"},"MassnahmeMitText":{"additionalProperties":false,"properties":{"beschreibung":{"type":"string"},"externe_kennung":{"type":["string","null"]},"finding":{"format":"uuid","type":"string"},"frist":{"format":"date","type":"string"},"id":{"format":"uuid","type":"string"},"status":{"enum":["offen","in_umsetzung","nachweis_eingereicht","geschlossen","abgelehnt"],"type":"string"},"verantwortlich":{"type":"string"}},"required":["id","finding","status","frist","externe_kennung","verantwortlich","beschreibung"],"type":"object"},"Massnahmen":{"additionalProperties":false,"properties":{"massnahmen":{"items":{"$ref":"#/components/schemas/MassnahmeMitText"},"type":"array"}},"required":["massnahmen"],"type":"object"},"Pruefobjekt":{"additionalProperties":false,"properties":{"aktiv":{"type":"boolean"},"attribute":{"type":"object"},"bcm_relevant":{"type":"string"},"bereich":{"type":"string"},"betreiber":{"type":"string"},"email":{"type":"string"},"fuehrungskraft":{"type":"string"},"fuehrungskraft_email":{"type":"string"},"id":{"format":"uuid","type":"string"},"kennung":{"type":"string"},"kritikalitaet":{"type":"string"},"manager":{"type":"string"},"name":{"type":"string"},"owner":{"type":"string"},"schutzbedarf":{"type":"string"},"status":{"type":"string"},"typ":{"type":"string"}},"required":["kennung","name","status","typ","bcm_relevant","kritikalitaet","schutzbedarf","bereich","betreiber","owner","manager","email","fuehrungskraft","fuehrungskraft_email","attribute","aktiv","id"],"type":"object"},"Pruefobjekte":{"additionalProperties":false,"properties":{"gesamt":{"type":"integer"},"limit":{"type":"integer"},"objekte":{"items":{"$ref":"#/components/schemas/Pruefobjekt"},"type":"array"},"offset":{"type":"integer"}},"required":["gesamt","limit","offset","objekte"],"type":"object"},"Status":{"additionalProperties":false,"properties":{"api":{"type":"string"},"mandant":{"type":"string"},"schluessel":{"additionalProperties":false,"properties":{"name":{"type":"string"},"rechte":{"items":{"enum":["lesen","schreiben","grundgesamtheit"],"type":"string"},"type":"array"}},"required":["name","rechte"],"type":"object"},"umgebung":{"enum":["produktiv","sandbox"],"type":"string"},"version":{"type":"string"},"zeit":{"format":"date-time","type":"string"}},"required":["api","version","mandant","umgebung","schluessel","zeit"],"type":"object"}},"securitySchemes":{"schluessel":{"bearerFormat":"hk_\u2026","description":"API-Schl\u00fcssel des Mandanten mit den Rechten lesen, schreiben und/oder grundgesamtheit","scheme":"bearer","type":"http"}}},"info":{"description":"Schnittstelle je Mandant. Anmeldung mit API-Schl\u00fcssel im Kopf \u201eAuthorization: Bearer hk_\u2026\u201c (Schl\u00fcssel 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\u00e4gt \u201eAPI-Version\u201c und \u201eX-Hera-Umgebung\u201c (produktiv oder sandbox). Abgek\u00fcndigte Endpunkte senden \u201eDeprecation\u201c, \u201eSunset\u201c und einen Link auf den Nachfolger.","title":"Hera REST-API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/akten/{aid}":{"get":{"operationId":"akte","parameters":[{"description":"Kontrollakte","in":"path","name":"aid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Akte"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Stand einer Kontrollakte","tags":["Berichte und Kontrollakte"],"x-recht":"lesen"}},"/akten/{aid}.zip":{"get":{"operationId":"akte_laden","parameters":[{"description":"Kontrollakte","in":"path","name":"aid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/zip":{"schema":{"format":"binary","type":"string"}}},"description":"ZIP mit akte.json, akte.csv, Pr\u00fcfsummen, Zeitstempeln"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Kontrollakte herunterladen (sieben Tage)","tags":["Berichte und Kontrollakte"],"x-recht":"lesen"}},"/assets":{"get":{"operationId":"pruefobjekte","parameters":[{"in":"query","name":"limit","schema":{"default":200,"maximum":1000,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","schema":{"default":0,"minimum":0,"type":"integer"}},{"in":"query","name":"aktiv","schema":{"default":"true","enum":["true","false"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pruefobjekte"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Pr\u00fcfobjekte des Bestands","tags":["Grundgesamtheit"],"x-recht":"lesen"}},"/berichte/{bid}":{"get":{"operationId":"bericht","parameters":[{"description":"Bericht","in":"path","name":"bid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bericht"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Angaben zu einem freigegebenen Bericht mit Hash","tags":["Berichte und Kontrollakte"],"x-recht":"lesen"}},"/berichte/{bid}.{endung}":{"get":{"operationId":"bericht_datei","parameters":[{"description":"Bericht","in":"path","name":"bid","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"path","name":"endung","required":true,"schema":{"enum":["pdf","docx"],"type":"string"}}],"responses":{"200":{"content":{"application/pdf":{"schema":{"format":"binary","type":"string"}},"application/vnd.openxmlformats-officedocument.wordprocessingml.document":{"schema":{"format":"binary","type":"string"}}},"description":"Datei"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"409":{"$ref":"#/components/responses/F409"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Bericht als PDF oder DOCX (gepr\u00fcft gegen die Pr\u00fcfsumme)","tags":["Berichte und Kontrollakte"],"x-recht":"lesen"}},"/faelle/{fid}":{"get":{"operationId":"fall","parameters":[{"description":"Fall","in":"path","name":"fid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FallDetail"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Fall mit Dateien (nur Angaben), Nachweisen, R\u00fcckfragen und Bewertungen","tags":["F\u00e4lle und Bewertungen"],"x-recht":"lesen"}},"/faelle/{fid}/bewertungen":{"get":{"operationId":"bewertungen","parameters":[{"description":"Fall","in":"path","name":"fid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bewertungen"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Alle Fassungen der Bewertung eines Falls","tags":["F\u00e4lle und Bewertungen"],"x-recht":"lesen"}},"/findings":{"get":{"operationId":"findings","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Findings"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Findings mit Ma\u00dfnahmen","tags":["Findings und Ma\u00dfnahmen"],"x-recht":"lesen"}},"/findings/{xid}":{"patch":{"operationId":"finding_aendern","parameters":[{"description":"Finding","in":"path","name":"xid","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindingAendern"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindingKurz"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"422":{"$ref":"#/components/responses/F422"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Externe Kennung oder Status eines Findings setzen","tags":["Findings und Ma\u00dfnahmen"],"x-recht":"schreiben"}},"/kampagnen":{"get":{"operationId":"kampagnen","parameters":[{"in":"query","name":"limit","schema":{"default":100,"maximum":500,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","schema":{"default":0,"minimum":0,"type":"integer"}},{"in":"query","name":"status","schema":{"enum":["entwurf","laeuft","abgeschlossen","abgebrochen"],"type":"string"}},{"in":"query","name":"kontrolle","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kampagnen"}}},"description":"Erfolg"},"400":{"$ref":"#/components/responses/F400"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Kampagnen lesen","tags":["Kontrollen und Kampagnen"],"x-recht":"lesen"}},"/kampagnen/{cid}":{"get":{"operationId":"kampagne","parameters":[{"description":"Kampagne","in":"path","name":"cid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KampagneDetail"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Kampagne mit Ablauf und Ergebnissen","tags":["Kontrollen und Kampagnen"],"x-recht":"lesen"}},"/kampagnen/{cid}/akte":{"post":{"operationId":"akte_anfordern","parameters":[{"description":"Kampagne","in":"path","name":"cid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Akte"}}},"description":"L\u00e4uft bereits"},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Akte"}}},"description":"Angefordert"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"409":{"$ref":"#/components/responses/F409"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Kontrollakte als ZIP anfordern (Hintergrundauftrag)","tags":["Berichte und Kontrollakte"],"x-recht":"lesen"}},"/kampagnen/{cid}/berichte":{"get":{"operationId":"berichte","parameters":[{"description":"Kampagne","in":"path","name":"cid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Berichte"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Freigegebene Kontrollberichte einer Kampagne","tags":["Berichte und Kontrollakte"],"x-recht":"lesen"}},"/kampagnen/{cid}/faelle":{"get":{"operationId":"faelle","parameters":[{"description":"Kampagne","in":"path","name":"cid","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"query","name":"limit","schema":{"default":100,"maximum":500,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","schema":{"default":0,"minimum":0,"type":"integer"}},{"in":"query","name":"status","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Faelle"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"F\u00e4lle einer Kampagne mit Status, KI-Vorschlag und Bewertung","tags":["F\u00e4lle und Bewertungen"],"x-recht":"lesen"}},"/kampagnen/{cid}/start":{"post":{"description":"Nur mit festgeschriebener Auswahl und g\u00fcltigen Mailadressen. 409 nennt die Hindernisse.","operationId":"kampagne_starten","parameters":[{"description":"Kampagne","in":"path","name":"cid","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KampagneStarten"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kampagne"}}},"description":"Erfolg"},"400":{"$ref":"#/components/responses/F400"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"409":{"$ref":"#/components/responses/F409"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Kampagne starten","tags":["Kontrollen und Kampagnen"],"x-recht":"schreiben"}},"/kontrollen":{"get":{"operationId":"kontrollen","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kontrollen"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Kontrollen lesen","tags":["Kontrollen und Kampagnen"],"x-recht":"lesen"}},"/mail/bounces":{"post":{"operationId":"bounce","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bounce"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BounceErgebnis"}}},"description":"Erfolg"},"400":{"$ref":"#/components/responses/F400"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Unzustellbarkeit einer Einladung melden","tags":["Allgemein"],"x-recht":"schreiben"}},"/massnahmen":{"get":{"operationId":"massnahmen","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Massnahmen"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Ma\u00dfnahmen","tags":["Findings und Ma\u00dfnahmen"],"x-recht":"lesen"}},"/massnahmen/{mid}":{"patch":{"operationId":"massnahme_aendern","parameters":[{"description":"Ma\u00dfnahme","in":"path","name":"mid","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MassnahmeAendern"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Massnahme"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"422":{"$ref":"#/components/responses/F422"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Externe Kennung oder Status einer Ma\u00dfnahme setzen","tags":["Findings und Ma\u00dfnahmen"],"x-recht":"schreiben"}},"/openapi.json":{"get":{"operationId":"openapi","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"OpenAPI-Dokument"}},"security":[],"summary":"Diese Beschreibung (OpenAPI 3.1)","tags":["Allgemein"],"x-recht":null}},"/populations":{"get":{"operationId":"importe","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Importe"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Letzte 50 Importe","tags":["Grundgesamtheit"],"x-recht":"lesen"},"post":{"description":"Standardattribute wie in der Oberfl\u00e4che, weitere unter \u201eattribute\u201c. Bis 20.000 Pr\u00fcfobjekte und 30 MB.","operationId":"grundgesamtheit_liefern","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Liefern"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LieferErgebnis"}}},"description":"Import angelegt"},"400":{"$ref":"#/components/responses/F400"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"413":{"$ref":"#/components/responses/F413"},"422":{"$ref":"#/components/responses/F422"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Grundgesamtheit liefern (Vorschau oder \u00dcbernahme)","tags":["Grundgesamtheit"],"x-recht":"grundgesamtheit"}},"/populations/{iid}":{"get":{"operationId":"import","parameters":[{"description":"Import","in":"path","name":"iid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Import"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"403":{"$ref":"#/components/responses/F403"},"404":{"$ref":"#/components/responses/F404"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Ein Import","tags":["Grundgesamtheit"],"x-recht":"lesen"}},"/status":{"get":{"description":"Jeder g\u00fcltige Schl\u00fcssel, unabh\u00e4ngig von seinen Rechten.","operationId":"status","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Status"}}},"description":"Erfolg"},"401":{"$ref":"#/components/responses/F401"},"429":{"$ref":"#/components/responses/F429"}},"summary":"Verbindung, Umgebung und Rechte des Schl\u00fcssels pr\u00fcfen","tags":["Allgemein"],"x-recht":null}}},"security":[{"schluessel":[]}],"servers":[{"url":"https://cockpit.kritera.de/api/v1"}],"tags":[{"name":"Allgemein"},{"name":"Grundgesamtheit"},{"name":"Kontrollen und Kampagnen"},{"name":"F\u00e4lle und Bewertungen"},{"name":"Findings und Ma\u00dfnahmen"},{"name":"Berichte und Kontrollakte"}],"webhooks":{"campaign.closed":{"post":{"operationId":"webhook_campaign_closed","parameters":[{"in":"header","name":"X-Hera-Ereignis","required":true,"schema":{"const":"campaign.closed"}},{"description":"Unix-Zeit der Zustellung in Sekunden","in":"header","name":"X-Hera-Zeit","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-Hera-Zustellung","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"\u201esha256=\u201c und HMAC-SHA256 (hex) \u00fcber \u201e<X-Hera-Zeit>.<K\u00f6rper>\u201c mit dem Geheimnis des Webhooks","in":"header","name":"X-Hera-Signatur","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Ereignis"},{"properties":{"daten":{"additionalProperties":false,"properties":{"bericht":{"additionalProperties":false,"properties":{"fassung":{"type":"integer"},"hash":{"type":"string"},"id":{"format":"uuid","type":"string"}},"required":["id","fassung","hash"],"type":"object"},"ergebnisse":{"type":"object"},"faelle":{"type":"integer"},"findings":{"type":"integer"},"kampagne":{"format":"uuid","type":"string"},"kontrolle":{"format":"uuid","type":"string"},"titel":{"type":"string"}},"required":["kampagne","titel","kontrolle","faelle","ergebnisse","findings","bericht"],"type":"object"},"ereignis":{"const":"campaign.closed"}},"type":"object"}]}}},"required":true},"responses":{"2XX":{"description":"Angenommen; alles andere gilt als Fehler und wird wiederholt"}},"summary":"Kampagne abgeschlossen","tags":["Webhooks"]}},"case.escalated":{"post":{"operationId":"webhook_case_escalated","parameters":[{"in":"header","name":"X-Hera-Ereignis","required":true,"schema":{"const":"case.escalated"}},{"description":"Unix-Zeit der Zustellung in Sekunden","in":"header","name":"X-Hera-Zeit","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-Hera-Zustellung","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"\u201esha256=\u201c und HMAC-SHA256 (hex) \u00fcber \u201e<X-Hera-Zeit>.<K\u00f6rper>\u201c mit dem Geheimnis des Webhooks","in":"header","name":"X-Hera-Signatur","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Ereignis"},{"properties":{"daten":{"additionalProperties":false,"properties":{"fall":{"format":"uuid","type":"string"},"kampagne":{"format":"uuid","type":"string"},"objekt":{"type":["string","null"]},"stufe":{"type":"integer"}},"required":["fall","objekt","kampagne","stufe"],"type":"object"},"ereignis":{"const":"case.escalated"}},"type":"object"}]}}},"required":true},"responses":{"2XX":{"description":"Angenommen; alles andere gilt als Fehler und wird wiederholt"}},"summary":"Fall eskaliert (Stufe 2)","tags":["Webhooks"]}},"case.reviewed":{"post":{"operationId":"webhook_case_reviewed","parameters":[{"in":"header","name":"X-Hera-Ereignis","required":true,"schema":{"const":"case.reviewed"}},{"description":"Unix-Zeit der Zustellung in Sekunden","in":"header","name":"X-Hera-Zeit","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-Hera-Zustellung","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"\u201esha256=\u201c und HMAC-SHA256 (hex) \u00fcber \u201e<X-Hera-Zeit>.<K\u00f6rper>\u201c mit dem Geheimnis des Webhooks","in":"header","name":"X-Hera-Signatur","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Ereignis"},{"properties":{"daten":{"additionalProperties":false,"properties":{"ergebnis":{"enum":["erfuellt","teilweise","nicht_erfuellt","nicht_relevant"],"type":"string"},"fall":{"format":"uuid","type":"string"},"fassung":{"type":"integer"},"kampagne":{"format":"uuid","type":"string"},"objekt":{"type":["string","null"]},"schweregrad":{"type":["string","null"]}},"required":["fall","objekt","kampagne","ergebnis","schweregrad","fassung"],"type":"object"},"ereignis":{"const":"case.reviewed"}},"type":"object"}]}}},"required":true},"responses":{"2XX":{"description":"Angenommen; alles andere gilt als Fehler und wird wiederholt"}},"summary":"Bewertung abgeschlossen","tags":["Webhooks"]}},"case.submitted":{"post":{"operationId":"webhook_case_submitted","parameters":[{"in":"header","name":"X-Hera-Ereignis","required":true,"schema":{"const":"case.submitted"}},{"description":"Unix-Zeit der Zustellung in Sekunden","in":"header","name":"X-Hera-Zeit","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-Hera-Zustellung","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"\u201esha256=\u201c und HMAC-SHA256 (hex) \u00fcber \u201e<X-Hera-Zeit>.<K\u00f6rper>\u201c mit dem Geheimnis des Webhooks","in":"header","name":"X-Hera-Signatur","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Ereignis"},{"properties":{"daten":{"additionalProperties":false,"properties":{"fall":{"format":"uuid","type":"string"},"kampagne":{"format":"uuid","type":"string"},"objekt":{"type":["string","null"]},"status":{"type":"string"}},"required":["fall","objekt","kampagne","status"],"type":"object"},"ereignis":{"const":"case.submitted"}},"type":"object"}]}}},"required":true},"responses":{"2XX":{"description":"Angenommen; alles andere gilt als Fehler und wird wiederholt"}},"summary":"Einreichung abgeschlossen","tags":["Webhooks"]}},"finding.created":{"post":{"operationId":"webhook_finding_created","parameters":[{"in":"header","name":"X-Hera-Ereignis","required":true,"schema":{"const":"finding.created"}},{"description":"Unix-Zeit der Zustellung in Sekunden","in":"header","name":"X-Hera-Zeit","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-Hera-Zustellung","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"\u201esha256=\u201c und HMAC-SHA256 (hex) \u00fcber \u201e<X-Hera-Zeit>.<K\u00f6rper>\u201c mit dem Geheimnis des Webhooks","in":"header","name":"X-Hera-Signatur","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Ereignis"},{"properties":{"daten":{"$ref":"#/components/schemas/FindingKurz"},"ereignis":{"const":"finding.created"}},"type":"object"}]}}},"required":true},"responses":{"2XX":{"description":"Angenommen; alles andere gilt als Fehler und wird wiederholt"}},"summary":"Finding angelegt","tags":["Webhooks"]}},"measure.updated":{"post":{"operationId":"webhook_measure_updated","parameters":[{"in":"header","name":"X-Hera-Ereignis","required":true,"schema":{"const":"measure.updated"}},{"description":"Unix-Zeit der Zustellung in Sekunden","in":"header","name":"X-Hera-Zeit","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-Hera-Zustellung","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"\u201esha256=\u201c und HMAC-SHA256 (hex) \u00fcber \u201e<X-Hera-Zeit>.<K\u00f6rper>\u201c mit dem Geheimnis des Webhooks","in":"header","name":"X-Hera-Signatur","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Ereignis"},{"properties":{"daten":{"$ref":"#/components/schemas/Massnahme"},"ereignis":{"const":"measure.updated"}},"type":"object"}]}}},"required":true},"responses":{"2XX":{"description":"Angenommen; alles andere gilt als Fehler und wird wiederholt"}},"summary":"Ma\u00dfnahme ge\u00e4ndert","tags":["Webhooks"]}}}}
