API Ironfang Finance
Types de problème
Chaque erreur renvoyée par l'API Ironfang Finance est un problème RFC 9457 doté d'un code stable. Chaque code a un seul statut HTTP et une seule URL type, et cette URL est une page de ce site. L'API répond en anglais ; les titres et descriptions de cette page sont traduits.
| Code | Statut | Titre | Remarques |
|---|---|---|---|
billing_required | 402 | Abonnement Ironfang Finance requis | |
delivery_unavailable | 503 | Livraison indisponible | Peut contenir retry_after_seconds |
generation_failed | 500 | Échec de la génération | Issue indéterminée, rien facturé |
idempotency_conflict | 409 | Conflit d'idempotence | |
insufficient_scope | 403 | Portée insuffisante | |
internal_error | 500 | Erreur interne | |
jobs_unavailable | 503 | Tâches asynchrones indisponibles | Peut contenir retry_after_seconds |
malformed_request | 400 | Requête mal formée | |
not_found | 404 | Introuvable | |
payload_too_large | 413 | Contenu trop volumineux | |
profile_undetected | 422 | Profil non détecté | |
quota_exhausted | 429 | Quota épuisé | Peut contenir retry_after_seconds |
rate_limited | 429 | Limite de débit atteinte | Peut contenir retry_after_seconds |
render_timeout | 504 | Délai dépassé pour le PDF lisible | |
render_unavailable | 503 | Moteur de PDF lisible indisponible | |
report_incomplete | 422 | Constats conservés incomplets | |
report_unavailable | 503 | Rapport signé indisponible | |
result_gone | 410 | Résultat indisponible | |
ruleset_disabled | 410 | Jeu de règles désactivé | |
unauthenticated | 401 | Non authentifié | |
unknown_ruleset | 422 | Jeu de règles inconnu | |
unsupported_content_type | 415 | Type de contenu non pris en charge | |
unsupported_document_type | 422 | Type de document non pris en charge | |
unsupported_profile | 422 | Profil non pris en charge | |
validation_timeout | 504 | Délai de validation dépassé | Issue indéterminée, rien facturé |
validator_unavailable | 503 | Validateur indisponible | Peut contenir retry_after_seconds. Issue indéterminée, rien facturé |
Un constat de validation n'est jamais un problème : une facture non valide est une réponse réussie qui liste ses constats, et la règle de chaque constat est expliquée dans la référence des règles de validation. Les autres API Ironfang utilisent un corps d'erreur plus simple, décrit dans la référence de chaque produit.