Engineering guide
API-Fehlertaxonomie fuer Dateipipelines
Definieren Sie stabile, umsetzbare Fehlerklassen fuer Upload- und Verarbeitungs-APIs.
Code
Sicherheit
Dokument
Bild
Video
Audio
Archiv
Warum Fehlertaxonomie wichtig ist
Ohne stabile Taxonomie koennen Clients und Support Nutzungsfehler nicht von Plattformdefekten unterscheiden. Ein typisiertes Fehlermodell verbessert Retry-Logik, Telemetriequalitaet und Incident-Triage.
Empfohlene Klassen
- input_invalid: fehlerhafte oder richtlinienwidrige Nutzereingabe.
- type_mismatch: Widerspruch zwischen Erweiterung, Signatur und Parser.
- processing_failed: Fehler bei Decode, Transcode oder Extraktion.
- resource_limited: Quote, Timeout oder Parallelitaetsbudget ueberschritten.
- internal_error: unerwarteter Servicefehler.
Betriebsregeln
Jede Klasse sollte auf deterministische Statuscodes, Retry-Regeln und nutzerseitige Nachrichtenmuster abbilden. Instrumentieren Sie Metriken nach Klasse und Reason Code, damit Regressionen messbar werden.
Empfohlene Werkzeuge