Scène de développeur abstraite avec une serrure connectée, un ordinateur portable et des graphiques de nœuds d’interface flottants reliés par de fins traînées de lumière bleue sur un bureau sombre, éclairage technique froid, sans personne, sans texte lisible et sans logo
Technologie

API et SDK pour serrures connectées : comment les logiciels ouvrent réellement les portes

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.

Faits essentiels

API et SDK en un coup d’œil

API cloudLes 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 mobileLes 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.
AuthentificationLes 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 APILes 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énementsLes 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érielleLes 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 politiqueNous 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.
Unité de réponse

Quel chemin d’intégration un projet doit-il emprunter ?

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égrationEnsemble d’outils principalDépendance essentielle
Émettre des codes de location datésAPI cloud depuis le système de réservationLes serrures doivent prendre en charge le type de code ciblé et le chemin de synchronisation.
Application locataire de marqueSDK mobile et API cloudL’é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 PMSService d’habilitations et couverture de la passerelle aux portes.
Borne de gestion des visiteursAPI cloud pour les habilitations à usage uniqueLes fuseaux horaires et les règles d’expiration sont validés tôt.
Conciergerie à distance en directDéverrouillage par API cloud et confirmation par webhookSeules les serrures en ligne exécutent instantanément les commandes à distance.
Portefeuille d’entreprise hors ligneSDK mobile avec habilitations locales sécuriséesRègles de stockage des clés et de révocation sur l’appareil.
Domaines d’application

Projets, produits et preuves

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.

OuverturePorte typiqueApproche de la serrure
Porte d’unité de locationSerrure Bluetooth avec passerelle par zoneLe système de réservation crée des codes hors ligne et en ligne via l’API cloud.
Entrée vitrée d’un bureauLecteur ou contrôleur en ligneLa plateforme visiteurs envoie des habilitations à usage unique et reçoit des webhooks d’entrée.
Chambre d’hôtelSerrure RFID avec service de clé mobileLe middleware du PMS appelle l’API des clés ; la passerelle transmet les mises à jour en direct.
Porte d’espace de coworkingSerrure connectée derrière une façade vitréeL’application membre intègre le SDK pour le déverrouillage à proximité, même avec un faible signal Wi-Fi.
Portail logistiqueSerrure extérieure en ligneLes commandes à distance exigent une connectivité confirmée et des contacts de secours.
Local de services annexesSerrure sur batterie gérée à distanceLe webhook audite les passages pour la facturation et l’examen des abus dans l’application de l’exploitant.
Dossier de documentation

Dossier de vérification préalable pour l’intégration

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.

ComposantLogique typiqueObservations
Référence de l’APIPoints 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 SDKVersions 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 quotasLimites 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énementsTypes 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.
Processus d’intégration

Conduire un projet d’intégration en cinq étapes

  1. Définir le modèle d’habilitationCartographier qui reçoit les codes, clés électroniques ou cartes et la manière dont ils expirent.
  2. Obtenir la documentation et l’environnement de testExaminer dès le départ la référence de l’API, les portées et les applications exemples du SDK.
  3. Développer avec des appareils de testDévelopper avec des modèles de serrures précis, et non avec des arguments marketing génériques.
  4. Tester les scénarios d’échecSimuler des serrures hors ligne, des webhooks en double, l’expiration des jetons et les limites de débit.
  5. Piloter puis mettre à l’échelleTester un bâtiment ou un étage d’hôtel avant le déploiement sur l’ensemble de la flotte.
FAQ

Questions sur les API et les SDK des serrures connectées

Quelle est la différence entre une API de serrure connectée et un SDK ?

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.

Notre plateforme de réservation peut-elle automatiquement envoyer un code pour chaque réservation ?

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.

Est-il sûr de permettre à une app de déverrouiller des portes à distance via une API ?

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 garantissent-ils la réception de chaque événement de porte ?

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.

Qui peut utiliser l'API : la marque, l'usine ou le client final ?

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.

Vous développez un logiciel pour du matériel de serrure connectée ?

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 technologies

Dernière mise à jour : 31 octobre 2026 · Reviewed by the Smart Lock Factory editorial team

Vos fraisVotre panier
Votre expérience sur ce site sera améliorée en autorisant les cookies. Politique relative aux cookies
Chat on WhatsApp