Connecter un hôte

Votre clé d’API prouve que vous êtes bien vous. Elle ne vous donne aucun droit sur les logements de qui que ce soit.

Pour cela, chacun de vos utilisateurs doit vous autoriser depuis son propre compte Localoge. C’est exactement le geste qu’il fait déjà pour connecter son compte Airbnb ou Booking chez vous.

Le parcours

Votre interface                Localoge                    Vous
─────────────────────────────────────────────────────────────────────
L'utilisateur coche
« Localoge », clique
sur Connecter
        │
        └──── redirection ───▶ Il se connecte
                               ou s'inscrit
                                    │
                               « Votre-outil souhaite
                                 gérer vos logements »
                                 [Autoriser] [Refuser]
                                    │
                               ◀─── redirection avec un code ───▶
                                                             Vous échangez
                                                             le code contre
                                                             un host_ref

Un utilisateur sans compte Localoge peut s’inscrire à cette étape

Il n’a pas besoin d’avoir déjà un compte chez nous. La page d’autorisation lui propose de s’en créer un en deux minutes, puis reprend le parcours là où il en était.

1. Envoyez votre utilisateur chez nous

https://localoge.com/connect
  ?partner=votre-identifiant
  &redirect_uri=https://votre-outil.com/callback/localoge
  &state=une-valeur-a-vous

Paramètre
partner	Votre identifiant, celui que nous vous avons communiqué avec la clé.
redirect_uri	Où nous renvoyons l’utilisateur ensuite. Doit correspondre à ce que vous nous avez déclaré.
state	Une valeur à vous, que nous vous rendons telle quelle. Servez-vous en pour vérifier que la réponse correspond bien à la demande que vous avez émise.

Ouvrez cette adresse dans le navigateur de l’utilisateur, pas côté serveur : c’est lui qui doit se connecter et cliquer.

2. Nous vous le renvoyons

S’il autorise :

https://votre-outil.com/callback/localoge?code=9f2c1a44…&state=une-valeur-a-vous

S’il refuse :

https://votre-outil.com/callback/localoge?error=access_denied&state=une-valeur-a-vous

3. Échangez le code contre une référence

curl -X POST https://localoge.com/api/v1/channel/oauth/token \
  -H "Authorization: Bearer $LOCALOGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "9f2c1a44…" }'

{ "success": true, "data": { "host_ref": "lh_4f8a2c…", "host_name": "Conciergerie Mont Blanc" } }

Le code vit dix minutes et ne sert qu’une fois

Il voyage dans une URL, donc dans l’historique du navigateur, vos journaux et le référent de la page suivante. Échangez-le immédiatement, et ne le conservez pas.

4. Gardez le host_ref et mettez-le partout

C’est lui qui dit à quel compte appartient chaque logement que vous nous envoyez :

{
  "external_property_id": "PROP-4821",
  "host_ref": "lh_4f8a2c…",
  "title": "Studio vue mer"
}

Il ne change jamais, y compris si l’utilisateur retire puis redonne son autorisation. Conservez-le à côté du compte de cet utilisateur, comme vous conservez ses identifiants Airbnb.

Un host_ref refusé n’est pas une erreur de format

Si nous répondons FORBIDDEN sur un host_ref qui marchait hier, c’est que l’utilisateur a retiré son autorisation depuis son espace Localoge. Nous ne basculons jamais sur un autre compte : ce serait écrire chez quelqu’un qui n’a rien accepté.

Prévenez-le et renvoyez-le sur /connect : la même référence lui sera rendue.

Un cas particulier : vous gérez vos propres logements

Si vous n’êtes pas un Channel Manager mais un gestionnaire qui a développé son propre outil pour ses propres logements, il n’y a personne à faire autoriser. Dites-le nous : nous rattachons votre compte Localoge à votre clé, et vous pouvez omettre host_ref.

C’est le seul cas où ce champ est facultatif.