Nous envoyer une réservation

Quand un séjour est vendu ailleurs, envoyez-le nous : nous bloquons les nuits, et le logement cesse d’être proposé sur Localoge.

curl -X POST https://localoge.com/api/v1/channel/reservations \
  -H "Authorization: Bearer $LOCALOGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_reservation_id": "RES-99001",
    "external_property_id": "PROP-4821",
    "check_in": "2026-09-10",
    "check_out": "2026-09-15",
    "guest": {
      "first_name": "Marie",
      "last_name": "Duval",
      "email": "marie.duval@exemple.fr",
      "phone": "+33612345678"
    },
    "guests_count": 3,
    "adults_count": 2,
    "total_amount": 72500,
    "currency": "EUR"
  }'

{
  "success": true,
  "data": { "reservation_id": "LOC-3f8a…", "created": true, "status": "confirmed" }
}

Ce que Localoge fait, et ne fait pas

Ne débite rien. Le voyageur a payé chez vous. Il n’y a ni carte enregistrée, ni empreinte de caution, ni frais de service, ni commission. total_amount est une information, pas un montant à encaisser : il sert à l’hôte et à vos statistiques.

Bloque les nuits de l’arrivée au départ exclu, et rend le séjour visible à l’hôte.

Le voyageur

Un compte Localoge est créé pour lui, à partir de son adresse. Il ne peut pas s’y connecter tant qu’il n’a pas défini un mot de passe lui-même, ne reçoit aucun message promotionnel de notre part, et ne compte pas dans nos statistiques d’inscription.

L’adresse est le seul champ obligatoire du bloc guest : c’est elle qui permet de reconnaître un voyageur qui revient plutôt que de lui créer un compte de plus.

Modifier une réservation

Le voyageur décale son séjour, ou vient à trois au lieu de deux. Envoyez seulement ce qui change.

curl -X PUT https://localoge.com/api/v1/channel/reservations/RES-9912 \
  -H "Authorization: Bearer $LOCALOGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "check_in": "2026-11-12", "check_out": "2026-11-16", "guests_count": 3 }'

{
  "success": true,
  "data": {
    "reservation_id": "17cf258c-…",
    "check_in": "2026-11-12",
    "check_out": "2026-11-16"
  }
}

L’identifiant dans l’URL est le VÔTRE (external_reservation_id), comme pour l’annulation.

Code	Situation
`200`	Modifiée.
`404 RESERVATION_NOT_FOUND`	Cet identifiant n’existe pas chez nous.
`409 DATES_UNAVAILABLE`	Les nouvelles nuits sont déjà prises. L’ancienne réservation est intacte.
`400 INVALID_PAYLOAD`	Dates incohérentes, ou réservation déjà annulée.

Codes de réponse

Code	Situation
`201`	Créée.
`200`	Elle existait déjà : votre rejeu n’a rien créé de neuf. Voir Idempotence.
`404 PROPERTY_NOT_FOUND`	Ce `external_property_id` n’existe pas chez nous. Poussez le logement d’abord.
`409 DATES_UNAVAILABLE`	Une ou plusieurs de ces nuits sont déjà prises chez nous.