Format de réponse erreur
Toutes les erreurs métier suivent la même enveloppe JSON :Le champ
error.code est un entier stable. Codez votre logique de retry/alerting sur ce code, pas sur le message (qui peut évoluer).Codes applicatifs Fluximmo
Une erreur de validation est renvoyée en 422, pas en 400, et ne contient qu’un seul message même si plusieurs champs sont invalides. Corrigez, rappelez, recommencez — ou validez côté client avant l’appel.
Codes HTTP standards
Certaines routes utilisent aussi des 2xx métier qui ne sont pas des erreurs :
202 (collecte en cours) et 422 enveloppé dans data (annonce rejetée par l’ingestion) sur /adverts/url et /properties/url. Distinguez-les d’une vraie erreur par la clé racine : data contre error.Exemple de gestion d’erreur
Voir aussi Bonnes pratiques pour les patterns de retry recommandés.

