Ironfang Finance API
Problemtypen
Jeder Fehler, mit dem die Ironfang Finance API antwortet, ist ein Problem nach RFC 9457 mit einem stabilen Code. Jeder Code hat genau einen HTTP-Status und eine type-URL, und diese URL ist eine Seite hier. Die API antwortet auf Englisch; Titel und Beschreibungen auf dieser Seite sind übersetzt.
| Code | Status | Titel | Hinweise |
|---|---|---|---|
billing_required | 402 | Abonnement für Ironfang Finance erforderlich | |
delivery_unavailable | 503 | Zustellung nicht verfügbar | Kann retry_after_seconds enthalten |
generation_failed | 500 | Erzeugung fehlgeschlagen | Ausgang unbestimmt, nichts berechnet |
idempotency_conflict | 409 | Idempotenzkonflikt | |
insufficient_scope | 403 | Unzureichende Berechtigung | |
internal_error | 500 | Interner Fehler | |
jobs_unavailable | 503 | Asynchrone Jobs nicht verfügbar | Kann retry_after_seconds enthalten |
malformed_request | 400 | Fehlerhafte Anfrage | |
not_found | 404 | Nicht gefunden | |
payload_too_large | 413 | Nutzdaten zu groß | |
profile_undetected | 422 | Profil nicht erkannt | |
quota_exhausted | 429 | Kontingent ausgeschöpft | Kann retry_after_seconds enthalten |
rate_limited | 429 | Ratenlimit erreicht | Kann retry_after_seconds enthalten |
render_timeout | 504 | Zeitüberschreitung beim lesbaren PDF | |
render_unavailable | 503 | Engine für lesbare PDFs nicht verfügbar | |
report_incomplete | 422 | Gespeicherte Befunde unvollständig | |
report_unavailable | 503 | Signierter Bericht nicht verfügbar | |
result_gone | 410 | Ergebnis nicht mehr verfügbar | |
ruleset_disabled | 410 | Regelwerk deaktiviert | |
unauthenticated | 401 | Nicht authentifiziert | |
unknown_ruleset | 422 | Unbekanntes Regelwerk | |
unsupported_content_type | 415 | Nicht unterstützter Inhaltstyp | |
unsupported_document_type | 422 | Nicht unterstützter Dokumenttyp | |
unsupported_profile | 422 | Nicht unterstütztes Profil | |
validation_timeout | 504 | Zeitüberschreitung bei der Validierung | Ausgang unbestimmt, nichts berechnet |
validator_unavailable | 503 | Validator nicht verfügbar | Kann retry_after_seconds enthalten. Ausgang unbestimmt, nichts berechnet |
Ein Validierungsbefund ist nie ein Problem: Eine ungültige Rechnung ist eine erfolgreiche Antwort, die ihre Befunde auflistet, und die Regel jedes Befunds wird in der Referenz der Validierungsregeln erklärt. Die anderen APIs von Ironfang verwenden einen einfacheren Fehlerkörper, der in der Referenz des jeweiligen Produkts beschrieben ist.