Skip to main content
L’API Fluximmo renvoie deux familles de codes : les codes HTTP standards (statut transport) et les codes applicatifs Fluximmo (raison métier précise).

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

10003 est générique, pas spécifique : un 404 « ressource inexistante » et une erreur inattendue portent le même code. C’est le statut HTTP qui vous dit quoi faire ; le code applicatif affine la cause.
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.