Espace développeur
L’espace développeur est l’endroit où vous gérez votre intégration vous-même. Il existe en deux exemplaires, un par instance, chacun avec ses propres données :
| Instance | Adresse |
|---|---|
| Production | https://developers.localoge.com/app/dev |
| Sandbox | https://sandbox.localoge.com/app/dev |
Votre compte de production est ouvert quand votre demande d’intégration est acceptée. Votre compte
sandbox se crée depuis la production (bouton Accéder au sandbox) : vous recevez le lien pour y
poser votre mot de passe, et une première clé lok_test_, affichée une seule fois.
Applications
Section intitulée « Applications »Une application regroupe une URL de webhook, ses événements et ses adresses de retour
(redirect_uri) pour l’autorisation des hôtes. La plupart des partenaires n’en ont qu’une.
Clés et portées
Section intitulée « Clés et portées »La liste de vos clés, avec leur environnement, leur date de dernier usage et leurs portées. À la création, cochez les portées dont l’usage a besoin ; sans portée cochée, la clé peut tout faire. Le secret s’affiche une seule fois.
En production, la création d’une clé lok_live_ exige que l’accès à la production vous ait été
accordé.
Rotation
Section intitulée « Rotation »Le bouton Rotation crée une nouvelle clé et donne 7 jours à l’ancienne avant qu’elle n’expire. Voir Authentification.
Chaque appel à l’API, avec sa méthode, son chemin, son code HTTP, sa durée, son code d’erreur et
son request_id. Filtres : erreurs seulement, un request_id précis, un identifiant externe
(logement ou réservation). C’est la première page à ouvrir quand « ça ne marche pas ».
Webhooks livrés
Section intitulée « Webhooks livrés »Toutes nos livraisons vers votre URL : pending, delivered, failed, avec le nombre de
tentatives et la dernière réponse de votre serveur. Deux boutons :
- Relancer une livraison échouée, une fois votre serveur réparé ;
- Envoyer un test : un
webhook.testsigné, vers votre URL enregistrée.
Équivalents API : GET /webhooks/deliveries, POST /webhooks/deliveries/{id}/retry,
POST /webhooks/test.
Les réceptions du miroir webhook-echo : ce que nous avons envoyé, en-têtes
compris, avec notre verdict sur la signature.
Simulateur (sandbox)
Section intitulée « Simulateur (sandbox) »Provoquer une réservation, une modification, une annulation, un message, un avis ou la validation d’un logement, puis observer le webhook arriver. Voir Simulateur. Un bouton Remettre à zéro efface vos logements, séjours et messages de test.
Boîte de test (sandbox)
Section intitulée « Boîte de test (sandbox) »Les e-mails que le sandbox aurait envoyés. Aucun ne sort réellement : c’est ici que vous vérifiez ce que l’hôte et le voyageur auraient reçu.
Conformité
Section intitulée « Conformité »Le tableau des contrôles de conformité, recalculé sur votre journal. Chaque contrôle en échec dit ce qui manque.
Production
Section intitulée « Production »La demande d’accès à la production. Elle est refusée tant qu’un contrôle de conformité échoue,
avec le détail. Une fois la demande envoyée, un administrateur Localoge l’examine ; vous êtes
prévenu par e-mail quand l’accès est accordé, et vous pouvez alors créer votre clé lok_live_.
Les personnes de votre société qui ont accès à l’espace. Ajoutez-en, retirez-en : chacune se connecte avec sa propre adresse.