Distribuez vos logements sur Localoge

Localoge est une plateforme française de location de logements de courte durée. Cette API permet à un PMS, un Channel Manager ou un distributeur de pousser les logements de ses utilisateurs vers Localoge, d’y synchroniser tarifs et disponibilités, et de récupérer les réservations.

Ce que fait cette API

Votre PMS / Channel Manager
        ↓  logements, tarifs, disponibilités, réservations
     API Localoge
        ↓
   Voyageurs Localoge
        ↓  réservations, annulations
   Webhooks vers vous

La synchronisation va dans les deux sens. Vous nous envoyez ce que vous gérez, nous vous renvoyons ce que nous vendons dessus. C’est ce second sens qui empêche la double réservation : sans lui, vous continueriez à proposer ailleurs des nuits déjà louées chez nous.

En cinq minutes

Vous demandez l’intégration ; une fois acceptée, vous ouvrez votre espace développeur et, de là, votre accès au sandbox.
Vous vérifiez votre clé de test (lok_test_…) : GET /ping sur l’URL du sandbox.
Un hôte de test vous autorise, et vous obtenez un host_ref. Voir Connecter un hôte.
Vous poussez un logement : POST /properties, puis ses disponibilités et ses tarifs.
Vous déclarez votre URL de webhook, et le simulateur vous envoie une réservation.
Votre conformité passe au vert.
Vous demandez la production, et recevez votre clé lok_live_….

Deux instances, deux URL de base

	URL de base	Clés
Sandbox	`https://sandbox.localoge.com/api/v1/channel`	`lok_test_…`
Production	`https://localoge.com/api/v1/channel`	`lok_live_…`

Le sandbox est une copie séparée de Localoge : son serveur, sa base, son stockage. Rien n’y atteint la production. Voir Sandbox et mise en production.

Vos espaces développeur :

production : https://developers.localoge.com/app/dev
sandbox : https://sandbox.localoge.com/app/dev

Les exemples de cette documentation emploient l’URL de production ; remplacez-la par celle du sandbox tant que vous travaillez avec une clé de test.

v1 ne changera pas de contrat. Nous ajouterons des champs, jamais nous n’en renommerons ni n’en retirerons : une évolution incompatible passerait par v2, en vous laissant le temps de migrer. Voir le journal des changements et la référence de l’API.

Deux autorisations, et il en faut deux

La vôtre, c’est votre clé d’API : elle prouve que vous êtes bien vous.

Celle de chaque utilisateur, c’est le host_ref : il vous autorise à gérer SES logements, depuis son propre compte Localoge. Vous ne pouvez rien écrire sans lui.

C’est le même partage que chez Airbnb : votre accès partenaire ne vous donne pas les logements de vos clients, chacun vous les confie lui-même.

Deux principes à connaître avant d’écrire une ligne

Tous les montants sont en CENTIMES, et en euros. 12000 veut dire 120,00 euros. C’est l’erreur d’intégration la plus fréquente, et elle passe inaperçue jusqu’à la première réservation.

Toutes les dates sont au format YYYY-MM-DD, sans heure et sans fuseau. Une nuit du 10 au 15 septembre s’écrit check_in: "2026-09-10", check_out: "2026-09-15" : l’arrivée est comprise, le départ ne l’est pas. Cela fait cinq nuits.

Demander l’intégration

Vous éditez un PMS ou un Channel Manager et vous voulez ajouter Localoge à vos canaux ?

Demander l’intégration

Nous vous répondons, et si la demande est acceptée vous recevrez le lien de votre espace développeur, d’où vous ouvrez votre accès au sandbox et créez votre clé d’essai. C’est ensuite dans cet espace que vous gérerez vos clés, vos adresses de retour et votre journal d’appels, sans avoir à nous écrire.

Nous écrire

Une question à laquelle cette documentation ne répond pas est un défaut de cette documentation. Écrivez à contact@localoge.com, en citant le request_id que portent toutes nos réponses d’erreur : il nous mène directement à votre appel.