
L’intégration des serrures à une application, à un PMS ou à une plateforme de bâtiment s’effectue au moyen de deux ensembles d’outils distincts : des API cloud pour les opérations à distance et des SDK Bluetooth pour le contrôle à portée de téléphone. Les confondre constitue l’erreur la plus fréquente lors de la planification d’une intégration.
Lorsqu’une application tierce doit piloter des serrures connectées — un canal de location qui émet des codes, une plateforme de bureau qui provisionne les visiteurs ou une application d’hôtel qui distribue des clés mobiles — le fabricant de serrures expose des interfaces programmables sur deux couches. L’API cloud est généralement un service de type REST transmis via HTTPS : l’application s’authentifie avec des identifiants de type OAuth, crée des codes d’accès ou clés électroniques, envoie des commandes de déverrouillage à distance pour les serrures en ligne, interroge l’état des serrures et reçoit des callbacks webhook pour les événements de déverrouillage, de batterie faible et de tentative de manipulation. Le SDK mobile est une bibliothèque intégrée à l’application iOS ou Android de l’intégrateur qui gère la détection Bluetooth, la connexion sécurisée, le déverrouillage à proximité et la logique d’habilitations hors ligne sans aller-retour vers un serveur. Les intégrations réussies utilisent délibérément les deux couches, sécurisent leurs identifiants et testent les limites de débit ainsi que la diffusion des événements avant la mise en production. Ce guide présente les concepts et les questions essentielles à poser aux fournisseurs. La disponibilité des API et des SDK, leurs portées et leurs conditions de licence pour chaque plateforme sont confirmées par écrit dans chaque devis.
| API cloud | Les services HTTPS gèrent depuis un serveur les serrures, les habilitations et les événements ; ils accèdent aux portes à distance uniquement lorsque les serrures sont en ligne via Wi-Fi ou une passerelle. |
| SDK mobile | Les bibliothèques iOS/Android intégrées gèrent la connexion Bluetooth, le déverrouillage à proximité et la logique hors ligne au sein de l’application de l’intégrateur. |
| Authentification | Les identifiants client de type OAuth, les jetons à portée limitée et les webhooks signés distinguent les plateformes professionnelles des scripts de relais ouverts. |
| Habilitations par API | Les opérations courantes créent des codes d’accès datés, des clés électroniques, des cartes et des liens visiteurs, avec des points de terminaison de listes, de mise à jour et de révocation. |
| Diffusion des événements | Les webhooks signalent les déverrouillages, l’utilisation des codes, les batteries faibles et les événements de porte ; le comportement de nouvelle tentative et les garanties d’ordre doivent être documentés. |
| Dépendance matérielle | Les commandes à distance ne s’exécutent que sur les serrures en ligne via Wi-Fi ou une passerelle ; la conception de l’API et la topologie matérielle doivent donc être planifiées ensemble. |
| Notre politique | Nous fournissons la documentation des interfaces, un environnement de test ou des appareils de test et un contact technique ; les identifiants de production et les limites sont fournis par la convention de plateforme. |
L’automatisation côté serveur (canaux de location, PMS, gestion des visiteurs) repose sur l’API cloud ; les applications mobiles de marque offrant un contrôle à proximité ou hors ligne ajoutent le SDK mobile. Les produits nécessitant les deux devraient concevoir le modèle d’habilitation avant d’écrire le code.
| Objectif d’intégration | Ensemble d’outils principal | Dépendance essentielle |
|---|---|---|
| Émettre des codes de location datés | API cloud depuis le système de réservation | Les serrures doivent prendre en charge le type de code ciblé et le chemin de synchronisation. |
| Application locataire de marque | SDK mobile et API cloud | L’équipe de l’application gère la publication du SDK et l’examen par les magasins d’applications. |
| Distribution de clés mobiles hôtelières | Événements de l’API cloud depuis le middleware du PMS | Service d’habilitations et couverture de la passerelle aux portes. |
| Borne de gestion des visiteurs | API cloud pour les habilitations à usage unique | Les fuseaux horaires et les règles d’expiration sont validés tôt. |
| Conciergerie à distance en direct | Déverrouillage par API cloud et confirmation par webhook | Seules les serrures en ligne exécutent instantanément les commandes à distance. |
| Portefeuille d’entreprise hors ligne | SDK mobile avec habilitations locales sécurisées | Règles de stockage des clés et de révocation sur l’appareil. |
Les API rencontrent la réalité physique au moment de l’ouverture : les passerelles, les portes métalliques et l’autonomie de la batterie déterminent si un appel API fluide atteint une serrure à temps. Pilotez conjointement le matériel et le logiciel.
| Ouverture | Porte typique | Approche de la serrure |
|---|---|---|
| Porte d’unité de location | Serrure Bluetooth avec passerelle par zone | Le système de réservation crée des codes hors ligne et en ligne via l’API cloud. |
| Entrée vitrée d’un bureau | Lecteur ou contrôleur en ligne | La plateforme visiteurs envoie des habilitations à usage unique et reçoit des webhooks d’entrée. |
| Chambre d’hôtel | Serrure RFID avec service de clé mobile | Le middleware du PMS appelle l’API des clés ; la passerelle transmet les mises à jour en direct. |
| Porte d’espace de coworking | Serrure connectée derrière une façade vitrée | L’application membre intègre le SDK pour le déverrouillage à proximité, même avec un faible signal Wi-Fi. |
| Portail logistique | Serrure extérieure en ligne | Les commandes à distance exigent une connectivité confirmée et des contacts de secours. |
| Local de services annexes | Serrure sur batterie gérée à distance | Le webhook audite les passages pour la facturation et l’examen des abus dans l’application de l’exploitant. |
Les API se ressemblent dans les présentations, mais diffèrent en production. Avant d’engager du temps d’ingénierie, les intégrateurs devraient recueillir les éléments ci-dessous, dont nous coordonnons la mise à disposition avec l’équipe de la plateforme.
| Composant | Logique typique | Observations |
|---|---|---|
| Référence de l’API | Points de terminaison, portées, versions et disponibilité d’un environnement de test. | Les estimations d’ingénierie dépendent d’une documentation complète et à jour. |
| Paquet SDK | Versions d’OS prises en charge, applications exemples et fréquence de publication. | Les modèles d’examen par les magasins et de maintenance doivent être compris. |
| Modèle de sécurité | Types de jetons, rotation des secrets, signature des webhooks et options de restriction par IP. | La protection des points de terminaison de déverrouillage est indispensable en production. |
| Limites et quotas | Limites de débit, pagination, opérations par lot et règles de nouvelle tentative. | Sans ces éléments, les déploiements de flotte peuvent échouer aux heures de pointe d’arrivée. |
| Catalogue des événements | Types d’événements, charges utiles, ordre et garanties de rediffusion. | Les fonctions d’audit et de notification dépendent de la fiabilité des événements. |
Une API est une interface de serveur à serveur : votre backend appelle la plateforme de serrures via HTTPS pour créer des codes, envoyer des commandes de déverrouillage aux serrures connectées, interroger leur statut et recevoir des événements webhook, indépendamment de la proximité du téléphone. Un SDK mobile est une bibliothèque logicielle intégrée à votre propre app iOS ou Android qui communique directement avec les serrures via Bluetooth, permettant le déverrouillage à proximité, la configuration et le stockage hors ligne des identifiants lorsqu'aucun serveur n'est accessible. Les backends de location et les intégrations PMS ont principalement besoin de l'API cloud ; les apps de marque destinées aux locataires ont généralement besoin du SDK, ainsi que de certaines API. Tenter de tout faire via l'API — par exemple déverrouiller une serrure exclusivement compatible Bluetooth depuis l'autre côté du monde sans passerelle — ne fonctionnera simplement pas : la topologie matérielle et le choix de l'interface doivent donc être conçus conjointement. Les interfaces disponibles pour chaque plateforme sont confirmées par écrit dans chaque devis.
Oui, c'est un modèle d'intégration standard : lorsqu'une réservation est confirmée, votre backend ou middleware appelle l'API de la plateforme de serrures avec la chambre ou l'unité, les dates d'arrivée et de départ, puis reçoit un code d'accès ou une clé électronique transmise au client via votre propre modèle de message ou d'e-mail. Les webhooks confirment ensuite l'utilisation et signalent des événements tels que les tentatives d'arrivée anticipée ou les batteries faibles. Les points à définir sont la gestion des fuseaux horaires pour les plages de dates, le type de code permettant un fonctionnement hors ligne sur les serrures choisies, la couverture des passerelles pour la révocation en temps réel, les nouvelles tentatives idempotentes en cas de renvoi de messages, ainsi que la manière dont les annulations et modifications de dates mettent à jour l'identifiant. Nous fournissons des serrures de test et.Contextualisons l'intégration en ateliers ; les détails des points de terminaison, les limites de débit et les licences pour chaque plateforme sont confirmés par écrit dans chaque devis.
Le déverrouillage à distance est sûr lorsque la plateforme est conçue comme toute API financière authentifiée : jetons de type OAuth avec portées limitées, stockage des secrets côté serveur, permissions par membre du personnel, confirmation des commandes via webhook, journaux d'audit et approbation facultative à double facteur pour les portes sensibles. Il devient dangereux lorsque les intégrateurs intègrent des secrets de longue durée dans des apps mobiles, exposent des points de terminaison de relais ouverts ou consignent les URL de déverrouillage. Les mesures de protection physique comptent également : les commandes à distance ne atteignent que les serrures connectées, et les portes à haute sécurité désactivent souvent entièrement le déverrouillage à distance ou exigent une double approbation. Lors de la due diligence, demandez le livre blanc sur la sécurité, la procédure de rotation des jetons et le schéma de signature des webhooks plutôt que d'accepter la seule affirmation selon laquelle une « API REST est disponible ». Nous coordonnons ces examinations avec l'équipe de la plateforme et pouvons proposer des architectures limitant le déverrouillage à distance à certains rôles, comme celui de la réception.
Les webhooks constituent le canal d'événements standard — déverrouillages, saisies de codes, batteries faibles, alertes de sabotage et changements d'état des capteurs de porte —, mais la sémantique de livraison varie selon la plateforme. Les plateformes professionnelles signent les charges utiles, réessaient les livraisons échouées avec un délai progressif et proposent une API pour rapprocher ou interroger les événements manqués, ce qui est important car les réseaux subissent de brèves pannes et les livraisons en double sont normales ; les consommateurs doivent donc traiter les identifiants d'événement de manière idempotente. Les garanties d'ordre sont plus limitées : deux événements générés à quelques secondes d'intervalle peuvent parfois arriver dans l'ordre inverse. La logique d'audit doit donc horodater les événements selon l'heure de l'événement de serrure plutôt que selon l'heure de réception. Pendant la phase pilote, simulez un récepteur hors ligne et vérifiez le comportement de réémission. Le catalogue des événements, la politique de nouvelle tentative et les points de terminaison de rapprochement de la plateforme choisie sont documentés par écrit avant le début du développement.
L'accès à l'API est accordé par la plateforme de serrures selon ses propres conditions de développement et commerciales, généralement au propriétaire du compte : la marque ou l'exploitant qui possède le projet cloud, et non automatiquement à chaque acheteur d'une serrure. L'usine peut aider à activer le service, fournir la documentation et coordonner l'intégration technique, mais elle ne peut pas attribuer de droits allant au-delà de l'accord de la plateforme. Certaines plateformes distinguent les utilisateurs exclusivement'apps, les comptes professionnels avec tableaux de bord et les partenaires développeurs certifiés disposant d'un accès complet à l'API ; quelques points de terminaison avancés exigent une revue d'intégration approuvée. Les acheteurs qui prévoient des intégrations approfondies doivent donc confirmer l'éligibilité au statut de développeur, les frais, les conditions de traitement des données et les régions prises en charge avant de choisir le matériel, car une excellente serrure sans droit d'accès à l'API ne peut pas prendre en charge le produit prévu. Les programmes développeurs et licences actuels de chaque plateforme sont confirmés pour chaque RFQ.
Partagez vos cas d'usage d'intégration, votre stack technique et votre calendrier de lancement dans votre RFQ. Nous coordonnons la documentation des API, les packages SDK, les appareils de test et les accords de plateforme, et vous aidons à mener un pilote conjoint couvrant le fonctionnement hors ligne, les nouvelles tentatives et les événements à grande échelle.
Demander une fiche technique et un devisAperçu des technologiesDernière mise à jour : 31 octobre 2026 · Reviewed by the Smart Lock Factory editorial team