Cycle de vie d'un logement

Les statuts

            complet                 validé (1er logement)
  draft ─────────────► pending_validation ─────────────► published
    ▲                                                     │   ▲
    │ il manque quelque chose                      pause  │   │ activate
    └─────────────────────────────────────────────────    ▼   │
                                                          paused

status	Visible des voyageurs	Sens
draft	non	Incomplet. missing dit ce qui manque.
pending_validation	non	Complet, en attente d’un administrateur Localoge.
published	oui	En vente.
paused	non	Retiré de la vente, réversible.

Chaque changement de statut vous est notifié par le webhook property.status_changed.

La validation du premier logement

Le premier logement de chaque partenaire passe en pending_validation dès qu’il est complet. Un administrateur Localoge le relit : mapping des équipements, montants en centimes, photos, adresse. Une fois validé, il est publié, et vos logements suivants se publient automatiquement dès qu’ils sont complets.

Deux changements repassent un logement publié en pending_validation : un nouveau titre et de nouvelles photos. Le reste (prix, calendrier, description, équipements) s’applique sans relecture.

En sandbox

La validation s’éprouve avec le simulateur : "event": "listing.validated" fait passer votre logement de pending_validation à published, comme le ferait un administrateur.

Mettre en pause

curl -X POST https://localoge.com/api/v1/channel/properties/PROP-4821/pause \
  -H "Authorization: Bearer $LOCALOGE_KEY"

{
  "success": true,
  "environment": "production",
  "data": { "external_property_id": "PROP-4821", "listing_id": "9f2c…", "status": "paused", "link_status": "paused" }
}

Le logement quitte la recherche et ne peut plus être réservé. Les séjours déjà réservés sont maintenus : une pause n’annule rien.

Réactiver

curl -X POST https://localoge.com/api/v1/channel/properties/PROP-4821/activate \
  -H "Authorization: Bearer $LOCALOGE_KEY"

Même forme de réponse. status vaut published si le logement est complet, pending_validation s’il doit encore être relu, ou draft s’il lui manque quelque chose (le champ missing d’un PUT /properties/{id} dit quoi).

Retirer définitivement : l’archivage

curl -X DELETE https://localoge.com/api/v1/channel/properties/PROP-4821 \
  -H "Authorization: Bearer $LOCALOGE_KEY"

DELETE archive le logement : il sort de la vente, mais son historique (séjours passés, avis, messages) est conservé, comme la loi et les litiges l’exigent. La réponse, comme GET /properties ensuite, porte status: "paused" et link_status: "archived". Le webhook property.status_changed part avec reason: "archived by partner".

Code	Situation
200	Archivé.
404 PROPERTY_NOT_FOUND	Cet identifiant n’existe pas chez nous.
409 CONFLICT	Un séjour est à venir sur ce logement. Annulez-le ou attendez qu’il soit passé.

Revenir en arrière

Un nouveau PUT /properties/{external_property_id} avec le même identifiant désarchive le logement : il reprend son historique au lieu d’en créer un second.

Relire les photos

curl https://localoge.com/api/v1/channel/properties/PROP-4821/photos \
  -H "Authorization: Bearer $LOCALOGE_KEY"

{
  "success": true,
  "environment": "production",
  "data": {
    "photos": [
      { "media_id": "m1…", "url": "https://localoge.com/uploads/…", "position": 0, "is_cover": true, "source_url": "https://votre-cdn.example.com/4821/1.jpg", "caption": null }
    ],
    "videos": [
      { "media_id": "v1…", "url": "https://localoge.com/uploads/…", "thumbnail_url": null, "position": 0, "source_url": "https://votre-cdn.example.com/4821/visite.mp4" }
    ]
  }
}

La couverture (is_cover) est la première photo dans l’ordre des positions. source_url est l’adresse d’où nous avons rapatrié la photo : c’est elle qui vous permet de rapprocher nos médias des vôtres. Voir Photos.