API Partenaire

Le principe en 30 secondes

Vos hôtes utilisent déjà vos messages automatiques pour accueillir leurs voyageurs. Avec l'API Partenaire, le lien sécurisé du livret d'accueil LodgBoost s'y insère tout seul, réservation après réservation.

Ce que LodgBoost gère pour vous

• Lien sécurisé unique par réservation — jamais de lien générique partagé entre voyageurs.
• Verrouillage intelligent — les informations sensibles (code d'entrée, wifi…) ne se déverrouillent qu'au moment choisi par l'hôte avant l'arrivée.
• Modifications de dates — renvoyez les nouvelles dates, le lien déjà envoyé au voyageur reste valable.
• Annulations — envoyez status=cancelled, le lien est révoqué immédiatement.
• Multilingue — le livret s'affiche automatiquement dans la langue du voyageur, aucun paramètre requis de votre côté.

Obtenez votre clé de test — instantané

Pas d'attente : remplissez ces deux champs et recevez immédiatement votre clé de test personnelle, avec un environnement de démonstration prêt à l'emploi (logement fictif « Villa Démo LodgBoost » et son code de liaison).

Cette clé ne sert qu'aux tests. La clé de production n'est délivrée qu'après la validation conjointe avec notre équipe (voir la procédure ci-dessous) — c'est elle qui fait apparaître votre logiciel dans l'application LodgBoost.

Documentation technique

Authentification

Chaque appel inclut votre clé API dans l'en-tête HTTP :

Authorization: Bearer lbp_votre_cle_api

URL de base

https://app.lodgboost.com/api/partner/v1

GET /ping — valider votre clé

# Réponse 200
{ "ok": true, "partner": "votre-slug", "mode": "test" }

POST /booklet-link — obtenir le lien du livret

L'unique endpoint métier. Appelez-le à la création d'une réservation, à chaque modification de dates, et à l'annulation.

# Requête
POST /api/partner/v1/booklet-link
{
  "link_code":      "LB-7F3K-92XA",      // code de liaison collé par l'hôte
  "reservation_id": "RES-2026-0042",     // VOTRE id de réservation
  "check_in":       "2026-07-15",
  "check_out":      "2026-07-20",
  "status":         "active"             // "active" | "cancelled"
}

# Réponse 200
{
  "booklet_link": "https://app.lodgboost.com/guest/…",
  "reservation_id": "RES-2026-0042",
  "state": "active"
}

• Idempotent : même reservation_id → même lien, à chaque appel. Rejouer un appel ne crée jamais de doublon.
• Modification de dates : renvoyez le même appel avec les nouvelles dates — le lien ne change pas.
• Annulation : "status": "cancelled" → le lien est révoqué ("booklet_link": null). Un ré-appel active le réactive, même URL.
• Important : obtenez le lien avant d'envoyer votre message. Si l'appel échoue après vos retries, retardez le message plutôt que d'envoyer une variable vide.

Codes d'erreur

Retries — obligation d'intégration

Tous les appels étant idempotents, rejouer est toujours sans risque. Implémentez un backoff simple :

for delay in [0, 1, 5, 30]:
    sleep(delay)
    r = POST /booklet-link
    if r.status == 200: return r.json["booklet_link"]
    if r.status == 429: sleep(r.headers["Retry-After"]); continue
    if r.status >= 500: continue
    raise  # autre 4xx : corriger la requête

Quota par défaut : 120 appels/minute par clé. Un volume supérieur (600+/min) s'active sur simple demande.

Devenir partenaire — la procédure

L'activation en production passe obligatoirement par une validation conjointe avec notre équipe. En échange, votre logiciel est mis en avant auprès de tous les hôtes LodgBoost.

1

1 · Obtenez votre clé de test

Instantané, via le formulaire ci-dessus : votre clé personnelle + le code de liaison du logement de démonstration.

2

2 · Intégrez et testez

Ajoutez le champ « Code de liaison LodgBoost » dans votre interface, votre variable dynamique dans vos modèles, et l'appel API avec retries. Testez librement : création, modification de dates, annulation.

3 · Validation conjointe — obligatoire

Écrivez à contact@lodgboost.com (objet « API Partenaire — Validation ») : nous vérifions ensemble que vos envois réels fonctionnent de bout en bout (lien correct dans le message, dates, annulation). Aucune clé de production n'est délivrée sans cette étape.

Demander la validation

4

4 · Activation & mise en avant

Nous activons votre clé de production validée. Votre logiciel apparaît alors automatiquement dans le groupe « Envoi automatique du livret » de l'application LodgBoost — visible par tous nos hôtes, aux côtés de nos intégrations existantes.

Gratuit pour les partenaires. L'API Partenaire est mise à disposition sans frais : votre logiciel gagne une fonctionnalité appréciée des hôtes, et les hôtes LodgBoost gagnent un envoi automatique de plus.