
L’integrazione delle serrature in un’app, un PMS o una piattaforma dell’edificio avviene tramite due insiemi di strumenti distinti: API cloud per le operazioni remote e SDK Bluetooth per il controllo dal telefono entro il raggio d’azione. Confonderli è l’errore più comune nella pianificazione dell’integrazione.
Quando un’applicazione di terze parti deve azionare serrature intelligenti — un canale di affitto che emette codici, una piattaforma aziendale che registra i visitatori o un’app per hotel che distribuisce chiavi mobili — il produttore della serratura espone interfacce programmabili su due livelli. L’API cloud è in genere un servizio di tipo REST su HTTPS: l’applicazione si autentica con credenziali di tipo OAuth, crea passcode o ekey, invia comandi di sblocco remoto per serrature online, interroga lo stato della serratura e riceve callback webhook per eventi di sblocco, batteria scarica e manomissione. L’SDK mobile è una libreria integrata nell’app iOS o Android dell’integratore che gestisce rilevamento Bluetooth, connessione sicura, sblocco nelle vicinanze e logica delle credenziali offline senza dover ricorrere a un server. Le integrazioni riuscite utilizzano deliberatamente entrambi i livelli, proteggono le credenziali e testano i limiti di frequenza e la consegna degli eventi prima del lancio. Questa guida illustra i concetti e le domande al produttore cui è importante rispondere. La disponibilità, l’ambito e la licenza di API e SDK per ciascuna piattaforma vengono confermati per iscritto in sede di preventivo.
| API cloud | I servizi HTTPS gestiscono da un server serrature, credenziali ed eventi; raggiungono porte remote solo quando le serrature sono online tramite Wi-Fi o un gateway. |
| SDK mobile | Librerie iOS/Android integrate gestiscono la connessione Bluetooth, lo sblocco nelle vicinanze e la logica offline all’interno dell’app dell’integratore. |
| Autenticazione | Credenziali client di tipo OAuth, token con ambiti specifici e webhook firmati distinguono le piattaforme professionali dagli script di relays aperti. |
| Credenziali tramite API | Le operazioni comuni creano passcode, ekey, tessere e link per visitatori con scadenza, oltre a endpoint per elencare, aggiornare e revocare. |
| Consegna degli eventi | I webhook notificano sblocchi, utilizzo dei codici, batteria scarica ed eventi relativi alla porta; il comportamento in caso di ritentativi e le garanzie sull’ordine devono essere documentati. |
| Dipendenza dall’hardware | I comandi remoti vengono eseguiti solo su serrature online tramite Wi-Fi o un gateway, pertanto la progettazione delle API e la topologia dell’hardware devono essere pianificate insieme. |
| La nostra politica | Forniamo documentazione delle interfacce, sandbox o dispositivi di test e un referente tecnico; le credenziali e i limiti per la produzione derivano dall’accordo con la piattaforma. |
L’automazione lato server (canali di affitto, PMS, gestione dei visitatori) si basa sull’API cloud; le app per telefono con marchio e controllo nelle vicinanze o offline aggiungono l’SDK mobile. I prodotti che richiedono entrambi dovrebbero progettare il modello delle credenziali prima di scrivere il codice.
| Obiettivo dell’integrazione | Insieme principale di strumenti | Dipendenza chiave |
|---|---|---|
| Emettere codici di affitto con scadenza | API cloud dal backend delle prenotazioni | Le serrature supportano il tipo di codice e il percorso di sincronizzazione previsti. |
| App per il tenant con il proprio marchio | SDK mobile più API cloud | Il team dell’app gestisce il rilascio dell’SDK e la revisione da parte dello store. |
| Consegna delle chiavi mobili in hotel | Eventi dell’API cloud dal middleware del PMS | Servizio delle credenziali e copertura del gateway presso le porte. |
| Chiosco per la gestione dei visitatori | API cloud per credenziali monouso | Fusi orari e semantica della scadenza validati in anticipo. |
| Concierge remoto in tempo reale | Sblocco tramite API cloud con conferma webhook | Solo le serrature online eseguono immediatamente i comandi remoti. |
| Portafoglio aziendale offline | SDK mobile con credenziali locali protette | Regole di archiviazione delle chiavi e di revoca sul dispositivo. |
Le API incontrano la realtà fisica all’apertura: gateway, porte metalliche e carico della batteria determinano se una chiamata API fluida raggiunge la serratura in tempo. Eseguire prove pilota su hardware e software insieme.
| Apertura | Porta tipica | Approccio alla serratura |
|---|---|---|
| Porta di un’unità in affitto | Serratura Bluetooth con gateway per area | Il backend delle prenotazioni crea codici offline e online tramite l’API cloud. |
| Ingresso vetrato di un ufficio | Lettreggio o controller online | La piattaforma per visitatori invia credenziali monouso e riceve webhook di accesso. |
| Camera dell’hotel | Serratura RFID con servizio di chiavi mobili | Il middleware del PMS richiama l’API delle chiavi; il gateway trasmette gli aggiornamenti in tempo reale. |
| Porta di un coworking | Serratura intelligente dietro una facciata vetrata | L’app per i membri integra l’SDK per lo sblocco nelle vicinanze, anche con un segnale Wi-Fi debole. |
| Cancello logistico | Serratura da esterno online | I comandi remoti richiedono una connettività confermata e contatti di fallback. |
| Locale dei servizi | Serratura a batteria gestita da remoto | I webhook supportano la verifica contabile e l’analisi degli abusi nell’app dell’operatore. |
Le API sembrano simili nelle presentazioni, ma differiscono in produzione. Prima di impegnare risorse di sviluppo, gli integratori dovrebbero raccogliere gli elementi indicati di seguito, per i quali aiutiamo a coordinare la collaborazione con il team della piattaforma.
| Componente | Logica tipica | Note |
|---|---|---|
| Documentazione di riferimento delle API | Endpoint, ambiti, versioni e disponibilità della sandbox. | Le stime di sviluppo dipendono da una documentazione completa e aggiornata. |
| Pacchetto SDK | Versioni dei sistemi operativi supportate, app di esempio e cadenza dei rilasci. | È necessario comprendere i modelli di approvazione da parte dello store e di manutenzione. |
| Modello di sicurezza | Tipi di token, rotazione dei segreti, firma dei webhook e opzioni relative agli IP. | La protezione degli endpoint di sblocco è indispensabile in produzione. |
| Limiti e quote | Limiti di frequenza, paginazione, operazioni in blocco e regole per i tentativi successivi. | Altrimenti, i lanci della flotta possono fallire nelle ore di punta per gli arrivi. |
| Catalogo degli eventi | Tipi di evento, payload, ordine e garanzie di riconsegna. | Le funzioni di audit e notifica dipendono da eventi affidabili. |
Un’API è un’interfaccia da server a server: il backend invoca la piattaforma delle serrature tramite HTTPS per creare codici, inviare comandi di sblocco alle serrature online, interrogare lo stato e ricevere eventi webhook; funziona indipendentemente dalla vicinanza del telefono. Un SDK mobile è una libreria software integrata nella vostra app iOS o Android che comunica direttamente con le serrature tramite Bluetooth, consentendo lo sblocco di prossimità, la configurazione e la memorizzazione offline delle credenziali quando nessun server è raggiungibile. I backend per affitti e le integrazioni PMS necessitano principalmente dell’API cloud; le app per tenant con marchio richiedono in genere l’SDK insieme ad alcune chiamate API. Tentare di fare tutto tramite l’API — ad esempio sbloccare dall’altra parte del mondo una serratura dotata solo di Bluetooth e senza gateway — semplicemente non funziona, pertanto la topologia hardware e la scelta dell’interfaccia devono essere progettate insieme. Le interfacce disponibili per ciascuna piattaforma vengono confermate per iscritto con ogni preventivo.
Sì, è un modello di integrazione standard: quando una prenotazione viene confermata, il vostro backend o middleware invoca l’API della piattaforma delle serrature indicando camera o unità, arrivo e partenza, e riceve un passcode o una ekey che viene consegnata all’ospite tramite il vostro messaggio o modello di email. I webhook confermano quindi l’utilizzo e segnalano eventi come tentativi di check-in anticipato o batterie scariche. I requisiti da definire includono la gestione dei fusi orari per gli intervalli di data, il tipo di codice che funziona offline sulle serrature selezionate, la copertura dei gateway per la revoca in tempo reale, i tentativi idempotenti quando i messaggi vengono reinviati e le modalità di aggiornamento delle credenziali in caso di cancellazioni o modifiche delle date. Forniamo serrature di prova e supportiamo i workshop di integrazione; i dettagli degli endpoint, i limiti di frequenza e le licenze per ciascuna piattaforma vengono confermati per iscritto con ogni preventivo.
Lo sblocco remoto è sicuro quando la piattaforma è progettata come qualsiasi API finanziaria autenticata: token in stile OAuth con ambiti limitati, archiviazione dei segreti lato server, permessi per singolo dipendente, conferma dei comandi tramite webhook, registri di audit e approvazione opzionale a due fattori per porte sensibili. Diventa pericoloso quando gli integratori incorporano segreti a lungo termine nelle app mobili, espongono endpoint relè aperti o registrano gli URL di sblocco. Anche le protezioni fisiche sono importanti: i comandi remoti raggiungono soltanto serrature online e le porte ad alta sicurezza spesso disattivano completamente lo sblocco remoto o richiedono una doppia approvazione. Durante la due diligence, richiedete il whitepaper sulla sicurezza, la procedura di rotazione dei token e lo schema di firma dei webhook anziché accettare l’affermazione che sia disponibile una “REST API”. Coordiamo queste verifiche con il team della piattaforma e possiamo proporre architetture che limitano lo sblocco remoto ai ruoli della reception.
I webhook sono il canale standard per gli eventi — registrazioni degli sblocchi, inserimenti di codici, batteria scarica, avvisi di manomissione e variazioni dei sensori delle porte — ma la semantica di consegna varia a seconda della piattaforma. Le piattaforme professionali firmano i payload, ritentano le consegne non riuscite con un backoff e forniscono un’API per riconciliare o interrogare gli eventi persi; ciò è importante perché le reti possono guastarsi temporaneamente e la consegna duplicata è normale; pertanto i consumatori devono trattare gli ID degli eventi in modo idempotente. Le garanzie sull’ordine sono più deboli: due eventi generati a pochi secondi di distanza possono occasionalmente arrivare in ordine inverso, quindi la logica di audit dovrebbe basarsi sul timestamp dell’evento della serratura anziché su quello di arrivo. Durante il pilot, simulate un ricevitore offline e verificate il comportamento del replay. Il catalogo degli eventi, la policy di retry e gli endpoint di riconciliazione per la piattaforma ordinata sono documentati per iscritto prima dell’inizio dello sviluppo.
L’accesso all’API è concesso dalla piattaforma delle serrature in base ai propri termini per sviluppatori e commerciali, in genere al proprietario dell’account: il marchio o l’operatore che possiede il progetto cloud, non automaticamente a ogni acquirente di una serratura. La fabbrica può aiutare ad attivare il servizio, fornire documentazione e coordinare l’onboarding tecnico, ma non può assegnare diritti oltre quanto previsto dall’accordo con la piattaforma. Alcune piattaforme distinguono tra utenti esclusivamente app, account aziendali con dashboard e partner sviluppatori certificati con accesso completo all’API; inoltre, pochi endpoint avanzati richiedono una revisione dell’integrazione approvata. Pertanto, gli acquirenti che prevedono integrazioni approfondite devono confermare idoneità come sviluppatori, costi, condizioni sul trattamento dei dati e aree supportate prima di selezionare l’hardware, perché un’ottima serratura senza diritti di accesso all’API non può supportare il prodotto pianificato. Gli attuali programmi per sviluppatori e le licenze per ciascuna piattaforma vengono confermati per ogni RFQ.
Condividete con la vostra RFQ i casi d’uso dell’integrazione, lo stack del team e il calendario di rilascio. Coordiamo la documentazione delle API, i pacchetti SDK, i dispositivi di prova e gli accordi con le piattaforme, e supportiamo un pilot congiunto che copre il funzionamento offline, i retry e gli eventi su larga scala.
Richiedi scheda tecnica e preventivoPanoramica delle tecnologieUltimo aggiornamento: 31 ottobre 2026 · Revisionato dal team editoriale di Smart Lock Factory