Conventions & erreurs

Les règles communes à tous les endpoints REST de Hussteer.

Conventions

• Format JSON en entrée comme en sortie (Content-Type: application/json).
• POST pour agir (publier, relancer), GET pour lire (état, historique).
• Codes HTTP standard : 200 succès, 401/404/409/422 erreurs métier, 5xx erreurs serveur.

Forme d'une erreur

Toute erreur renvoie un objet stable :

{
  "error": {
    "code": "POSTAL_CODE_REQUIRED",
    "message": "Le code postal est obligatoire pour publier l'annonce."
  }
}

Codes d'erreur métier

• UNAUTHORIZED (401) — authentification requise ou agence introuvable.
• PROPERTY_NOT_FOUND (404) — le bien n'existe pas ou n'appartient pas à votre agence.
• PUBLICATION_NOT_FOUND (404) — la publication n'existe pas ou n'est pas la vôtre.
• LISTING_INVALID (422) — l'annonce est incomplète (voir les blockers).
• POSTAL_CODE_REQUIRED (422) — le code postal est obligatoire.
• DELIVERY_NOT_CONFIGURED (409) — aucune méthode de livraison configurée.
• PORTAL_DISABLED (409) — un portail ciblé n'est pas activé pour votre agence.