Intégrations les plus courantes : comment faire

La couche API de LabKey est stable et utilisée en production depuis des années pour relier le contrôle d’accès à des logiciels de gestion, des PMS, des plateformes de réservation et des systèmes de paiement. Ce guide rassemble les patterns d’intégration les plus courants — basés sur des cas réels déjà en production, décrits ici de façon générique — pour s’orienter rapidement avant de concevoir sa propre intégration.

Comment démarrer une intégration

Trois approches sont possibles, selon les ressources techniques disponibles :

• Self-service : développez de façon autonome à partir de la documentation complète des API, également disponible en format interactif sur Postman.
• SDK et code de démarrage : l’équipe LabKey peut fournir des SDK et des extraits de code déjà prêts pour les patterns les plus courants, afin d’accélérer le développement.
• Intégration sur mesure : l’équipe LabKey peut développer l’intégration sur mesure pour le compte du client.

Contactez-nous pour évaluer ensemble la solution la plus adaptée à votre projet.

Patterns d’intégration les plus courants

Voici les patterns d’intégration les plus récurrents, tirés d’intégrations réellement en production (certaines depuis plusieurs années), décrits de façon générique.

Génération automatique d’identifiants depuis un logiciel de réservation

Le logiciel de réservation (PMS hôtelier, logiciel pour centres sportifs ou coworking) notifie la finalisation d’une réservation ou d’un check-in ; le système génère automatiquement un identifiant (code, clé NFC ou QR code) valable uniquement pour la période de séjour ou de réservation, et l’envoie à l’utilisateur.

Appels concernés : AddUser → GrantAccess → getqrcode ou UpdatePinpad → sendemail — voir les sections Utenti, Accessi e permessi et Generale de la documentation API.

Pattern typique pour l’intégration avec des logiciels de gestion cloud pour structures d’hébergement, comme Passepartout, Hotel in Cloud ou TeamSystem Hospitality (déjà partenaires LabKey).

Vérification d’autorisation auprès d’un système externe avant l’ouverture

Dans certains contextes (par exemple des organismes publics disposant de leur propre système d’autorisation), la demande d’ouverture ne provient pas directement de LabKey : un service externe vérifie d’abord l’autorisation auprès du logiciel tiers et, seulement en fonction du résultat, envoie la commande d’ouverture. Utile lorsque la logique d’autorisation doit rester centralisée dans un système déjà existant.

Accès à la consommation, avec crédit rechargeable

Un espace réservé externe permet à l’utilisateur de recharger un crédit (par ex. pour des entrées, des services ou des consommations décomptées) ; le crédit restant est automatiquement décompté à chaque accès, avec désactivation automatique de l’identifiant une fois le solde épuisé.

Appels concernés : getcredits, recharge, getprices — voir la section Crediti.

Auto-inscription publique avec confirmation d’un opérateur

Une page publique permet à l’utilisateur de s’inscrire de façon autonome ; le système génère un code provisoire, qui n’est activé définitivement qu’après confirmation manuelle d’un opérateur.

Appels concernés : AddUser (créé désactivé) → confirmation opérateur → GrantAccess.

Ouverture déclenchée par des automatisations no-code ou des formulaires en ligne

Le remplissage d’un formulaire en ligne (par ex. JotForm, déjà partenaire LabKey) ou une automatisation sur des plateformes d’automatisation no-code (par ex. Zapier, Make) peut déclencher directement l’ouverture d’un point d’accès, grâce aux appels de l’API PRO.

Paiement en ligne qui génère l’accès

Un site ou un e-commerce avec paiement intégré (par ex. Stripe) génère et envoie automatiquement un code d’accès à la finalisation d’une transaction.

Ouverture depuis sa propre application via QR code

Si l’ouverture doit se faire depuis sa propre application plutôt que depuis un lecteur physique, le flux typique est : AddUser → GrantAccess → getqrcode. L’application du client affiche ou traite le QR code renvoyé pour finaliser l’accès.

Alternative à évaluer en connaissance de cause : si l’on préfère agir directement sur le relais de l’unité de contrôle avec son propre dispositif externe (le contact est sec, normalement ouvert — NO — et peut être actionné en parallèle sans problème), on contourne complètement la couche API LabKey : pas d’authentification, pas de journal, aucune des fonctionnalités du panneau. C’est un choix valable si la logique d’autorisation est déjà gérée ailleurs, mais il doit être fait en connaissance de ce à quoi l’on renonce.

Coworking et espaces partagés

Groupes d’utilisateurs avec plages horaires personnalisables, accès temporaires via QR code, compteurs d’entrée et révocation des identifiants à distance sont toutes des fonctionnalités natives du système, également disponibles via API pour les intégrer à un site ou à un logiciel de réservation d’espaces.

Prérequis techniques

L’authentification (jeton Bearer, secret key associée à l’IP autorisée) est décrite dans la section Autenticazione de la documentation API. Deux aspects à garder à l’esprit lors de la conception :

• L’activation des API concerne toutes les unités de contrôle associées au panneau : il n’est pas possible de l’activer uniquement sur une sélection.
• Un environnement de test dédié est disponible, activable sur demande, pour valider l’intégration avant la mise en production.

Niveaux de service : Standard et PRO

Le service API Standard couvre la majorité des scénarios décrits ci-dessus. Le service API PRO ajoute l’ouverture à distance depuis des logiciels externes via des appels dédiés, ainsi qu’un suivi avancé avec journal des appels API.

Votre plateforme ne figure pas parmi les partenaires listés ?

Ce n’est pas un problème : les patterns décrits ci-dessus s’appliquent de la même façon à des plateformes qui ne figurent pas encore dans la liste publique des partenaires intégrés — par exemple, les principaux channel managers pour locations de courte durée comme Lodgify ne sont pas encore une intégration documentée, mais sont intégrables avec le même pattern standard.

Contactez-nous pour évaluer ensemble la faisabilité de votre intégration.