Gestion des erreurs

Format standard des erreurs

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Le champ 'insured_id' est requis.",
    "details": [
      {
        "field": "insured_id",
        "reason": "required"
      }
    ]
  }
}

Codes HTTP

Code	Signification	Action recommandée
400	Requête invalide	Vérifiez les paramètres envoyés
401	Non authentifié	Renouvelez votre token
403	Non autorisé	Vérifiez vos scopes
404	Ressource introuvable	Vérifiez l'identifiant
409	Conflit	La ressource existe déjà ou est verrouillée
422	Erreur de validation	Corrigez les champs invalides
429	Rate limit atteint	Attendez selon Retry-After header
500	Erreur serveur	Réessayez après 30s ; si persistant, contactez le support

Stratégie de retry

Retry avec backoff exponentiel :
  délai = min(base * 2^attempt, max_delay)
  base = 1s, max_delay = 60s

Retry sur : 429, 500, 502, 503, 504
Ne pas retry : 400, 401, 403, 404, 409, 422

Codes d'erreur métier

Code	Description
COVERAGE_EXPIRED	Couverture expirée
CEILING_EXCEEDED	Plafond de remboursement dépassé
DUPLICATE_CLAIM	Claim déjà soumis
INVALID_DIAGNOSIS	Code diagnostic invalide
FACILITY_SUSPENDED	Établissement suspendu