
Lukkojen integrointi sovellukseen, PMS-järjestelmään tai rakennusplatformiin tapahtuu kahden erillisen työkaluryhmän avulla: pilvi-API:t etäkäyttöön ja Bluetooth-SDK:t puhelimen lähellä tapahtuvaan ohjaukseen. Niiden sekoittaminen on yleisin integroinnin suunnitteluvirhe.
Kun kolmannen osapuolen sovelluksen on käytettävä älylukkoja — esimerkiksi vuokrauskanava, joka myöntää koodeja, toimiston alusta, joka rekisteröi vierailijoita, tai hotellisovellus, joka toimittaa mobiiliavaimia — lukon valmistaja tarjoaa ohjelmoitavat rajapinnat kahdessa kerroksessa. Pilvi-API on tyypillisesti REST-tyylinen HTTPS-palvelu: sovellus todentaa OAuth-tyylisillä tunnuksilla, luo pääsykoodeja tai ekeys-kokeja, lähettää etäavauskomentoja verkkolukkoihin, kysyy lukkojen tilaa ja vastaanottaa webhook-kutsuja avausta, alhaisen akkotasojen ja väärinkäytön tapahtumista. Mobiili-SDK on kirjasto, joka upotetaan integroijan omaan iOS- tai Android-sovellukseen ja käsittelee Bluetooth-laitteiden tunnistamista, turvallista yhteyttä, lähellä tapahtuvaa avausta sekä offline-tunnistetietojen logiikkaa ilman yhteyttä palvelimeen. Onnistuneet integraatiot käyttävät molempia kerroksia harkiten, suojaavat tunnuksensa ja testaavat raja-arvot sekä tapahtumien toimituksen ennen julkaisua. Tässä oppaassa kartoitetaan keskeiset käsitteet ja valmistajalle esitettävät tärkeät kysymykset. Kunkin alustan API- ja SDK-saavuus, käyttöoikeudet ja lisensointi vahvistetaan kirjallisesti tarjouskohtaisesti.
| Pilvi-API | HTTPS-palvelut hallitsevat lukkoja, tunnistetietoja ja tapahtumia palvelimelta; etäovet ovat saavutettavissa vain, kun lukot ovat verkossa Wi-Fi- tai yhdysväylän kautta. |
| Mobiili-SDK | Upotetut iOS-/Android-kirjastot käsittelevät Bluetooth-yhteyden, lähellä tapahtuvan avauksen ja offline-logiikan integroijan omassa sovelluksessa. |
| Todennus | OAuth-tyyliset asiakastunnnukset, rajatut tunnukset ja allekirjoitetut webhookit erottavat ammattimaiset alustat avoimista välitysskripteistä. |
| Tunnisteet API:n mukaan | Yleiset toiminnot luovat päivättyjä pääsykoodeja, ekeys-kokeja, kortteja ja vierailijalinkkejä sekä tarjoavat luettelointi-, päivitys- ja peruutusrajapinnat. |
| Tapahtumien toimitus | Webhookit ilmoittavat avauksista, koodin käytöstä, alhaisesta akkotasosta ja ovitapahtumista; uudelleenyritystoiminta ja järjestysvaatimukset on dokumentoitava. |
| Laitteistoriippuvuus | Etäkomennot suoritetaan vain verkkolukoissa Wi-Fi- tai yhdysväylän kautta, joten API-suunnittelu ja laitteistotopologia on suunniteltava yhdessä. |
| Käytäntömme | Tarjoamme rajapintadokumentaatiota, hiekkaympäristön tai testilaitteita sekä teknisen yhteyshenkilön; tuotantotunnisteet ja rajoitukset tulevat alustasopimuksesta. |
Palvelinpuolen automaatio (vuokrauskanavat, PMS, vierailijoiden hallinta) perustuu pilvi-API-ihin; brändätyt puhelimesovellukset, joissa käytetään lähellä tapahtuvaa tai offline-ohjausta, tarvitsevat mobiili-SDK:n. Tuotteiden, jotka tarvitsevat molemmat, kannattaa suunnitella tunnistemalli ennen koodin kirjoittamista.
| Integrointitavoite | Ensisijainen työkaluryhmä | Keskeinen riippuvuus |
|---|---|---|
| Päivättyjen vuokrauskooodien myöntäminen | Pilvi-API varausjärjestelmän taustajärjestelmästä | Lukot tukevat kohdekoodityyppiä ja synkronointipolku. |
| Brändätyt asukassovellus | Mobiili-SDK ja pilvi-API | Sovellustiimi vastaa SDK:n julkaisusta ja sovelluskaupan hyväksynnästä. |
| Hotellin mobiiliavaimen toimitus | Pilvi-API-tapahtumat PMS-välikkeestä | Tunnistepalvelu ja yhdysväylien kattavuus ovilla. |
| Vierailijoiden hallinnan kioski | Pilvi-API kertakäyttöisiin tunnisteisiin | Aikavyöhykkeet ja vanhenemissemantiikka on validoitava varhain. |
| Reaaliaikainen etäneuvonta | Pilvi-API-avaus ja webhook-vahvistus | vain verkkolukot suorittavat etäkomennot välittömästi. |
| Offline-yritysmaksu | Mobiili-SDK ja suojatut paikalliset tunnisteet | Avainten säilytys- ja peruutussäännöt laitteella. |
API:t kohtaavat fyysisen todellisuuden oven kohdalla: yhdysväylät, metalliovet ja akun käyttöaikaisuus määrittävät, ehtikö puhdas API-kutsu ehtii lukolle ajoissa. Testaa pilottilaitteisto ja -ohjelmisto yhdessä.
| Ovi | Tyypillinen ovi | Lukko |
|---|---|---|
| Vuokrausyksikön ovi | Bluetooth-lukko ja aluekohtainen yhdysväylä | Varausjärjestelmän taustajärjestelmä luo offline- ja online-koodeja pilvi-API:n kautta. |
| Toimiston lasiete-entry | Verkkolukija tai ohjain | Vierailija-alusta lähettää kertakäyttöisiä tunnisteita ja vastaanottaa sisäänkäynnin webhookeja. |
| Hotellin vierashuone | RFID-lukko ja mobiiliavainpalvelu | PMS-välikke kutsuu avain-API:a; yhdysväylä lähettää reaaliaikaiset päivitykset. |
| Yhteisötilan ovi | Älylukko lasijulkisivun takana | Jäsenisovellus upottaa SDK:n lähellä tapahtuvaan avaukseen myös heikon Wi-Fi-yhteyden aikana. |
| Logistiikkaportti | Ulkoinen verkkolukko | Etäkomennot edellyttävät vahvistettua yhteyttä ja varayhteyskontakteja. |
| Palvelutila | Etähallittu akkulukko | Webhook- auditsointi tukee laskutusta ja väärinkäytösten tarkastelua operaattorisovelluksessa. |
API:t näyttävät dioissa samankaltaisilta, mutta tuotannossa ne poikkeavat toisistaan. Ennen kuin integroijat sitovat suunnitteluresursseja, heidän kannattaa kerätä seuraavat tiedot, joiden koordinoinnissa autamme alustatiimiä.
| Osake | Tyypillinen logiikka | Huomioita |
|---|---|---|
| API-viittaus | Rajapinnat, käyttöoikeudet, versiot ja hiekkaympäristön saatavuus. | Suunnitteluaikataulut ja -arviot riippuvat täydellisestä ja ajantasaisesta dokumentaatiosta. |
| SDK-paketti | Tuetut käyttöjärjestelmäversiot, esimerkkisovellukset ja julkaisurytmi. | Kaupan hyväksyntä- ja ylläpitomallit on ymmärrettävä. |
| Turvallisuusmalli | Tunnustyypit, salaisuuksien kiertäminen, webhook-allekirjoitus ja IP-vaihtoehdot. | Avausrajapintojen suojaaminen on tuotannossa välttämätöntä. |
| Rajat ja kiintiöt | Pyyntöraja-arvot, sivutus, eräoperaatiot ja uudelleenyrityssäännöt. | Muuten laivajon käyttöönotto voi epäonnistua sisäänkirjautumisen ruuhka-aikoina. |
| Tapahtumaluettelo | Tapahtumatyypit, hyötekuormat, järjestys ja toimituksen varmuus. | Auditointi ja ilmoitusominaisuudet riippuvat luotettavista tapahtumista. |
API on palvelimelta palvelimelle toimiva liitännä: taustajärjestelmäsi kutsuu lukkoalustaa HTTPS-yhteyden kautta luodakseen koodeja, lähettääksesi lukituskomentoja online-lukoille, hakeakseen tilaa ja vastaanottaakseen webhook-tapahtumia. Se toimii riippumatta puhelimen läheisyydestä. Mobiili-SDK on omaksi iOS- tai Android-appiksi rakennettu ohjelmistokirjasto, joka keskustelee lukkojen kanssa suoraan Bluetoothin kautta ja mahdollistaa lähilukituksen, määritykset sekä tunnisteiden offline-tallennuksen, kun palvelimeen ei saada yhteyttä. Vuokrauksen taustajärjestelmät ja PMS-integraatiot tarvitsevat pääasiassa pilvi-API:n; brändatuotujen tenant-appit tarvitsevat yleensä SDK:n sekä valikoituja API-kutsuja. Kaiken tekeminen vain API:n kautta — esimerkiksi Bluetooth-only-lukon avaaminen toiselta puolelta maailmaa ilman yhdysvälittäjää — ei yksinkertaisesti toimi, joten laitteiston topologia ja liitännän valinta on suunniteltava yhdessä. Kunkin alustan käytettävissä olevat liitännät vahvistetaan kirjallisesti tarjouksen yhteydessä.
Kyllä, kyseessä on vakiintunut integraatiomalli: kun varaus on vahvistettu, taustajärjestelmäsi tai väliohjelmistosi kutsuu lukkoalustan API-tunnusta ja ilmoittaa huoneen tai yksikön sekä saapumis- ja lähtöpäivät. Se vastaanottaa pääsynkoodin tai ekeyn, joka toimitetaan vieraalle omalla viesti- tai sähköpostipohjallasi. Webhookit vahvistavat myöhemmin käytön ja merkitsevät tapahtumia, kuten ennenaikaista sisäänkirjautumisyritystä tai matalaa akkua. Täsmennettäviä vaatimuksia ovat päivämääräikkunoiden aikavyöhykkeiden käsittely, valittuihin lukkoihin offline-tilassa toimiva koodityyppi, yhdysvälittäjien kattavuus reaaliaikaiselle voimutukselle, idempotentet uudelleenlähetykset viestien lähettäessä sekä tunnisteiden päivitys peruutuksissa ja päivämäärämuutoksissa. Tarjoamme testilukkoja ja tuemme integraatiotyöpajoja; kunkin alustan päätepisteet, pyyntörajoitukset ja lisensointi vahvistetaan kirjallisesti tarjouksen yhteydessä.
Etäavaus on turvallinen, kun alusta on rakennettu minkä tahansa autentikoitua rahoitus-API:n tapaan: OAuth-tyylisillä tokeneilla, joilla on rajatut käyttöoikeudet, palvelinpuolen salaisuuksien tallennuksella, henkilökohtaisilla henkilöstöoikeuksilla, komentojen vahvistuksella webhookin kautta, auditolokeilla ja tarvittaessa kaksivaiheisella hyväksynnällä herkille oville. Vaaraksi muuttuu tilanne, kun integraattorit upottavat pitkäikäisiä salaisuuksia puhelinsovelluksiin, paljastavat avoimia relepäätepisteitä tai kirjaavat lukitus-URL-osoitteet. Myös fyysiset suojatoimet ovat tärkeitä: etäkomennot tavoittavat vain online-lukot, ja erittäin turvalliset ovet usein poistavat etäavauksen käytöstä kokonaan tai vaativat kaksinkertaisen hyväksynnän. Due diligence -vaiheessa pyydä tietoturvaa käsittelevää valkoista paperia, tokenien kiertämisohjeita ja webhookien allekirjoitussuunnitelmaa sen sijaan, että hyväksyisit pelkän väitteen ”REST API available”. Koordinoimme näitä arvioita alustatiimin kanssa ja voimme ehdottaa arkkitehtuureita, joissa etäavaus on rajoitettu vastaanottohenkilöille.
Webhookit ovat vakiintunut tapahtumakanava — lukituskirjaukset, koodien syöttö, matala akku, häiriöhälytykset ja oviantureiden muutokset — mutta toimituksen semanttiikka vaihtelee alustan mukaan. Ammattilaisalustat allekirjoittavat lataukset, yrittävät epäonnistuneiden toimitusten uudelleenlähetystä viiveen kasvattamisen kanssa ja tarjoavat API:n, jonka avulla voidaan täsmällistää tai kysellä puuttuvia tapahtumia. Tämä on tärkeää, koska verkot katkeavat hetkeksi ja päällekkäinen toimitus on normaalia; kuluttajien on siksi käsiteltävä tapahtumatunnuksia idempotenttisti. Järjestysvaatimukset ovat heikommat: kaksi muutaman sekunnin päässä syntynyttä tapahtumaa voivat toisinaan saapua päinvastaisessa järjestyksessä, joten auditointilogiikan kannattaa käyttää lukon tapahtuma-aikaa saapumisajan sijaan. Pilottivaiheessa simuloi offline-vastaanottaja ja varmista uudelleentoiston toiminta. Tilatun alustan tapahtumaluettelo, uudelleenlähetyskäytäntö ja täsmällistämispäätepisteet dokumentoidaan kirjallisesti ennen kehittämisen aloittamista.
Lukkoalusta myöntää API-käyttöoikeudut omien kehittäjä- ja kaupallisten ehtojensa mukaisesti, yleensä tilin omistajalle eli brändille tai toimijalle, joka omistaa pilviprojektin, ei automaattisesti jokaiselle lukon ostajalle. Tehdas voi auttaa palvelun käyttöönotossa, toimittaa dokumentaatiota ja koordinoida teknistä käyttöönottoa, mutta ei voi myöntää alustasopimuksen ulkopuolisia oikeuksia. Jotkin alustat erottavat vain sovellusta käyttävät käyttäjät, yritystilit kojelaitoineen ja sertifioidut kehittäjäkumppanit, joilla on täysi API-käyttöoikeus, ja osa edistyneistä päätepisteistä vaatii hyväksytyn integraatioarvioinnin. Syvällisiin integraatioihin ryhtyvien ostajien kannattaa siksi varmistaa kehittäjäkelpoisuus, maksut, tietojen käsittelyehdot ja tuetut alueet ennen laitteiston valintaa, koska erinomainen lukko ilman API-oikeuksia ei voi toteuttaa suunniteltua tuotetta. Kunkin alustan nykyiset kehittäjäohjelmat ja lisensointi vahvistetaan RFQ-tarjouksen yhteydessä.
Jaa integraatiotapaukset, tiimisi teknologiapinon ja julkaisuaikataulu RFQ-tarjouksesi yhteydessä. Koordinoimme API-dokumentaatiota, SDK-paketteja, testilaitteita ja alustasopimuksia sekä tuemme yhteistä pilottia, jossa testataan offline-toimintaa, uudelleenlähetyksiä ja laajuudeltaan suuren laiteiston tapahtumia.
Pyydä teknistä erittelyä ja tarjousTeknologioiden yleiskatsausViimeksi päivitetty: 31. lokakuuta 2026 · Smart Lock Factoryn toimituskunnan tarkastama