API 2.0.0: Aktiver Vertrag erforderlich
POST /incidents erfordert einen Vertrag mit Status active. Der Status approved reicht nicht aus. Ohne aktiven Vertrag scheitert die Anfrage mit HTTP 422 und EMPLOYEE_HAS_NO_ACTIVE_CONTRACT, auch bei dryRun=true; es wird kein Vorfall erstellt. Klären Sie den Vertragsstatus über den zuständigen Fachprozess, bevor Sie eine neue Anfrage mit neuer X-Request-ID senden.
Bestehende Vorfälle bleiben unter ihren bisherigen Lebenszyklus- und Feldbeschränkungen bearbeitbar. Die neue Voraussetzung gilt für das Erstellen. Die Voraussetzung der Mitarbeiteraktivierung bleibt separat dokumentiert; eine Reihenfolge der Validierungsfehler ist nicht festgelegt.
Vorfälle sind mit einem Mitarbeiter im API-Key-Scope verknüpft. Der referenzierte Mitarbeiter muss aktiviert sein, bevor ein Vorfall erstellt werden kann. Der Server setzt Meldermetadaten und Lifecycle-Status.
Fachliche Werte
Der Status wird serverseitig verwaltet; die öffentliche Patch-Operation stellt dokumentierte bearbeitbare Felder bereit, aber kein frei beschreibbares Statusupdate.
Endpoints
Vorfälle auflisten
Vorfälle nach Nummer, Typ, Status, Mitarbeiter, Melder und Datumsfeldern filtern und sortieren.
Vorfall erstellen
Einen temporären oder permanenten Vorfall für einen autorisierten und aktivierten Mitarbeiter melden.
Vorfall abrufen
Aktuellen serververwalteten Status und Datumsfelder lesen.
Vorfall aktualisieren
Unterstützte Typ- und Datumsfelder patchen; Vorfälle können nicht wiedereröffnet werden.
Anhänge hochladen
Zulässige Bild- oder PDF-Nachweise zu einem bearbeitbaren abgeschlossenen Vorfall hochladen.
Attachment-Grenzwerte
Integrationsleitfaden für Vorfälle
Prüfen Sie Lifecycle-Verantwortung, unterstützte Updates, Dateivalidierung und Kontrollen zur Datenminimierung.