Sandbox et mise en production

Le sandbox

Une clé lok_test_…, la même URL, et rien d’autre à configurer. C’est la clé qui décide de l’environnement, ce qui vous évite une variable de configuration de plus et le risque de la laisser au mauvais endroit.

Ce que le sandbox garantit :

• Les logements créés sont invisibles des voyageurs : pas de recherche, pas de page publique, pas de plan du site, aucun e-mail.
• Ils appartiennent à un compte hôte dédié à votre société, créé au premier essai. Vos essais n’apparaissent donc jamais chez un hôte réel.
• Aucun paiement réel n’est possible : le circuit de paiement n’est pas appelé du tout.
• Les webhooks sont envoyés normalement, signés de la même façon : vous pouvez éprouver votre réception de bout en bout.

Tout le reste se comporte comme en production, y compris les refus : nuits déjà prises, idempotence, limites de débit.

host_ref est ignoré en sandbox

Une clé d’essai écrit toujours sur son compte hôte dédié, même si vous présentez un host_ref valide. Sans cela, une erreur de configuration chez vous écrirait chez un hôte réel, et le sandbox ne protégerait plus rien.

Le parcours d’autorisation d’un hôte s’éprouve donc en production, avec un hôte qui vous a vraiment autorisé. C’est le seul point que le sandbox ne couvre pas.

Vous verrez "status": "published", et c’est normal

Un logement d’essai complet passe bien « publié » : nous voulons que votre parcours ressemble à la production, sinon votre essai ne prouve rien. Il reste invisible de tous. Si vous cherchez votre logement d’essai sur localoge.com, vous ne le trouverez pas : c’est le comportement attendu, pas un échec de votre intégration.

Ce que nous vous conseillons d’éprouver

Ne vous arrêtez pas au cas nominal. Ce sont les autres qui vous réveilleront la nuit.

1. Créer un logement, le relire, le republier à l’identique et vérifier unchanged: true.
2. Le publier réellement : trois photos, et regarder missing se vider.
3. Fermer puis rouvrir des nuits, et lire skipped.
4. Pousser un an de tarifs en une requête.
5. Nous envoyer une réservation, puis rejouer exactement le même appel : vous devez obtenir 200 et le même identifiant, jamais un doublon.
6. Réserver ces mêmes nuits une seconde fois, avec un autre identifiant : vous devez obtenir 409 DATES_UNAVAILABLE.
7. Annuler, et vérifier que les nuits sont rouvertes.
8. Vérifier une signature de webhook, et en refuser une falsifiée.
9. Répondre 500 volontairement à un webhook, et observer nos réessais.
10. Dépasser votre quota et vérifier que vous respectez Retry-After.

Les points 5, 6 et 8 sont ceux que nous regardons avant d’ouvrir la production.

Passer en production

1. Dites-nous que vous êtes prêt, en nous disant ce que vous avez éprouvé de la liste ci-dessus.
2. Nous vous remettons une clé lok_live_….
3. Vous redéclarez votre URL de webhook avec cette clé : les abonnements ne traversent pas les environnements.
4. Vous poussez un premier logement réel, et vous nous prévenez : nous le regardons ensemble avant que vous ne poussiez le reste.
5. Vous importez votre parc.

Le premier logement réel se regarde à deux

C’est vingt minutes qui évitent trois cents annonces à reprendre. Un mauvais mapping d’équipements ou une erreur de centimes ne se voit pas dans le sandbox, où personne ne lit les annonces.

Après la bascule

Gardez votre clé de test. Elle reste valide, et c’est là que vous éprouverez vos évolutions sans toucher à votre parc en vente.