Erreurs métier
Les erreurs de validation ou de traitement suivent l’enveloppe commune décrite dans Format des réponses. Le champerror contient un message ou un nom d’exception sous forme de texte libre.
Erreurs d’authentification
Les erreurs d’authentification (x-api-key invalide ou manquante) ne suivent pas l’enveloppe standard : elles sont renvoyées directement par le framework, avec un format différent.
Bonnes pratiques
1
Distinguez les deux formats
Vérifiez la présence de
statusCode pour identifier une erreur d’authentification, ou de code pour une erreur métier standard.2
Journalisez le champ error
Conservez le contenu de
error dans vos logs pour faciliter le diagnostic avec le support Paps.3
Implémentez une stratégie de nouvelle tentative
Pour les erreurs
500, prévoyez un mécanisme de retry avec backoff exponentiel.