Publier une annonce
Une annonce est identifiée par votre référence interne : la renvoyer met à jour l’annonce existante, jamais de doublon.
| Méthode | Route | Rôle |
|---|---|---|
| POST | /v1/listings | Créer une annonce (ou la mettre à jour si la référence existe) |
| PUT | /v1/listings/{ref} | Remplacer une annonce complète (la crée si besoin) |
| PATCH | /v1/listings/{ref} | Modifier quelques champs : prix, photos, statut… |
| DELETE | /v1/listings/{ref} | Retirer une annonce |
| GET | /v1/listings | Lister vos annonces (status, page, per_page) |
| GET | /v1/listings/{ref} | Lire une annonce |
| GET | /v1/stats | Vues, contacts et mises en favori par annonce |
Créer
Envoyez l’annonce complète (voir Champs d’une annonce). Réponse 201 à la création, 200 à la mise à jour :
Les warnings signalent sans bloquer : un bien identique déjà publié sous une autre de vos références (doublon_interne) ou par une autre agence (doublon_possible).
Baisser le prix, marquer vendu
Les personnes qui suivent le bien sont prévenues d’une baisse de prix ou de la vente, comme pour toutes les annonces du site.
Statuts
| status | Sur sitigeo.com |
|---|---|
| active | En ligne : recherche, carte, fiche |
| inactive | Masquée, gardée pour plus tard |
| sold | Fiche « vendu » |
| removed | Retirée (DELETE, ou absente d’une synchronisation) |