Journal des changements

v1 ne change pas de contrat : chaque entrée ci-dessous ajoute des routes, des champs ou des événements, sans rien renommer ni retirer. Votre code qui ignore les champs inconnus n’a rien à modifier.

2026-09-29

Sandbox séparé

• Le sandbox devient une copie séparée de Localoge sur https://sandbox.localoge.com : son serveur, sa base, son stockage. La production n’est jamais touchée.
• Les clés lok_test_ ne fonctionnent plus que sur https://sandbox.localoge.com/api/v1/channel, les clés lok_live_ que sur https://localoge.com/api/v1/channel. Une clé présentée à la mauvaise instance reçoit 401 UNAUTHORIZED avec l’adresse à utiliser.
• host_ref fonctionne désormais en sandbox : créez des comptes hôtes de test et autorisez-les.
• Aucun e-mail ne sort du sandbox : GET /sandbox/emails et la boîte de test de l’espace.
• POST /sandbox/reset pour repartir de zéro.
• La documentation et l’espace développeur de production passent sur https://developers.localoge.com.

Simulateur

• POST /sandbox/simulate : réservation, modification, annulation, message, avis ou validation de logement, émis par le même code que la production. Voir Simulateur.

Conformité

• GET /conformance : les contrôles calculés sur votre journal. La demande de production est refusée tant qu’un contrôle échoue. Voir Conformité.

Pagination

• limit, cursor et next_cursor sur GET /properties, GET /reservations, GET /events et GET /webhooks/deliveries. Voir Pagination.
• updated_since sur GET /reservations porte désormais sur la date de modification : une annulation ressort. Chaque réservation gagne updated_at.
• GET /events?since= : tous les événements émis pour vous, livrés ou non.

Cycle de vie des logements

• POST /properties/{id}/pause, POST /properties/{id}/activate, DELETE /properties/{id} (archivage, 409 CONFLICT si un séjour est à venir).
• GET /properties/{id}/photos (photos et vidéos, avec source_url).
• Nouveau champ property_type sur POST et PUT /properties.
• Nouveau statut pending_validation : le premier logement de chaque partenaire est relu par un administrateur. Voir Cycle de vie.

Réservations

• GET /reservations/{id}, par l’identifiant Localoge ou le vôtre : montants détaillés (amounts) et état du paiement.
• Les réservations que vous envoyez ne sont pas soumises aux restrictions Localoge (séjour minimum, jours d’arrivée).

Messagerie

• GET et POST /reservations/{id}/messages acceptent aussi l’identifiant Localoge : vous pouvez lire et répondre aux voyageurs des séjours vendus sur Localoge, qui sont prévenus (temps réel, notification, e-mail).

Webhooks

• Chaque corps porte api_version: "v1" et environment ; reservation.* gagne updated_at.
• Nouveaux événements : property.status_changed, host.revoked (un hôte vous a retiré son autorisation), webhook.test, et payment.succeeded / payment.refunded (loyer encaissé ou voyageur remboursé, réservations Localoge uniquement).
• GET /webhooks/deliveries, POST /webhooks/deliveries/{id}/retry, POST /webhooks/test.
• PUT /webhooks refuse (400 INVALID_PAYLOAD) un nom d’événement inconnu et une URL qui ne se résout pas vers une adresse publique.
• Portées : cycle de vie sous properties:write, événements et livraisons sous webhooks:read, relance et test sous webhooks:write.

Débit

• En-têtes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset sur toutes les réponses authentifiées ; Retry-After sur tout 429. Voir Limites.

Erreurs

• Nouveaux codes CONFLICT (409) et NOT_FOUND (404). Voir Erreurs.

Espace développeur

• Portées posables à la création d’une clé, rotation avec 7 jours de recouvrement, journal filtrable, livraisons de webhooks avec relance et test, miroir, simulateur, boîte de test, conformité.

Référence

• Spécification OpenAPI 3.1 et SDK TypeScript et PHP. Voir Référence.