Abstrakti kehittäjätilanne, jossa älylukko, kannettava tietokone ja kelluvia käyttöliittymäsolmuja yhdistävät ohuet siniset valojäljet pimeällä pöydällä, viileä tekninen valaistus, ei ihmisiä, ei luettavaa tekstiä, ei logoja
Teknologia

Älylukkojen API:t ja SDK:t: miten ohjelmisto oikeasti avaa ovia

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.

Keskeiset faktat

API:t ja SDK:t katsauksessa

Pilvi-APIHTTPS-palvelut hallitsevat lukkoja, tunnistetietoja ja tapahtumia palvelimelta; etäovet ovat saavutettavissa vain, kun lukot ovat verkossa Wi-Fi- tai yhdysväylän kautta.
Mobiili-SDKUpotetut iOS-/Android-kirjastot käsittelevät Bluetooth-yhteyden, lähellä tapahtuvan avauksen ja offline-logiikan integroijan omassa sovelluksessa.
TodennusOAuth-tyyliset asiakastunnnukset, rajatut tunnukset ja allekirjoitetut webhookit erottavat ammattimaiset alustat avoimista välitysskripteistä.
Tunnisteet API:n mukaanYleiset toiminnot luovat päivättyjä pääsykoodeja, ekeys-kokeja, kortteja ja vierailijalinkkejä sekä tarjoavat luettelointi-, päivitys- ja peruutusrajapinnat.
Tapahtumien toimitusWebhookit ilmoittavat avauksista, koodin käytöstä, alhaisesta akkotasosta ja ovitapahtumista; uudelleenyritystoiminta ja järjestysvaatimukset on dokumentoitava.
LaitteistoriippuvuusEtäkomennot suoritetaan vain verkkolukoissa Wi-Fi- tai yhdysväylän kautta, joten API-suunnittelu ja laitteistotopologia on suunniteltava yhdessä.
KäytäntömmeTarjoamme rajapintadokumentaatiota, hiekkaympäristön tai testilaitteita sekä teknisen yhteyshenkilön; tuotantotunnisteet ja rajoitukset tulevat alustasopimuksesta.
Vastausyksikkö

Mitä integrointipolku projekti tarvitsee?

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.

IntegrointitavoiteEnsisijainen työkaluryhmäKeskeinen riippuvuus
Päivättyjen vuokrauskooodien myöntäminenPilvi-API varausjärjestelmän taustajärjestelmästäLukot tukevat kohdekoodityyppiä ja synkronointipolku.
Brändätyt asukassovellusMobiili-SDK ja pilvi-APISovellustiimi vastaa SDK:n julkaisusta ja sovelluskaupan hyväksynnästä.
Hotellin mobiiliavaimen toimitusPilvi-API-tapahtumat PMS-välikkeestäTunnistepalvelu ja yhdysväylien kattavuus ovilla.
Vierailijoiden hallinnan kioskiPilvi-API kertakäyttöisiin tunnisteisiinAikavyöhykkeet ja vanhenemissemantiikka on validoitava varhain.
Reaaliaikainen etäneuvontaPilvi-API-avaus ja webhook-vahvistus vain verkkolukot suorittavat etäkomennot välittömästi.
Offline-yritysmaksuMobiili-SDK ja suojatut paikalliset tunnisteetAvainten säilytys- ja peruutussäännöt laitteella.
Sovelluskohteet

Projektit, tuotteet ja näyttö

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ä.

OviTyypillinen oviLukko
Vuokrausyksikön oviBluetooth-lukko ja aluekohtainen yhdysväyläVarausjärjestelmän taustajärjestelmä luo offline- ja online-koodeja pilvi-API:n kautta.
Toimiston lasiete-entryVerkkolukija tai ohjainVierailija-alusta lähettää kertakäyttöisiä tunnisteita ja vastaanottaa sisäänkäynnin webhookeja.
Hotellin vierashuoneRFID-lukko ja mobiiliavainpalveluPMS-välikke kutsuu avain-API:a; yhdysväylä lähettää reaaliaikaiset päivitykset.
Yhteisötilan oviÄlylukko lasijulkisivun takanaJäsenisovellus upottaa SDK:n lähellä tapahtuvaan avaukseen myös heikon Wi-Fi-yhteyden aikana.
LogistiikkaporttiUlkoinen verkkolukkoEtäkomennot edellyttävät vahvistettua yhteyttä ja varayhteyskontakteja.
PalvelutilaEtähallittu akkulukkoWebhook- auditsointi tukee laskutusta ja väärinkäytösten tarkastelua operaattorisovelluksessa.
Dokumentaatiopaketti

Integroinnin due diligence -paketti

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ä.

OsakeTyypillinen logiikkaHuomioita
API-viittausRajapinnat, käyttöoikeudet, versiot ja hiekkaympäristön saatavuus.Suunnitteluaikataulut ja -arviot riippuvat täydellisestä ja ajantasaisesta dokumentaatiosta.
SDK-pakettiTuetut käyttöjärjestelmäversiot, esimerkkisovellukset ja julkaisurytmi.Kaupan hyväksyntä- ja ylläpitomallit on ymmärrettävä.
TurvallisuusmalliTunnustyypit, salaisuuksien kiertäminen, webhook-allekirjoitus ja IP-vaihtoehdot.Avausrajapintojen suojaaminen on tuotannossa välttämätöntä.
Rajat ja kiintiötPyyntöraja-arvot, sivutus, eräoperaatiot ja uudelleenyrityssäännöt.Muuten laivajon käyttöönotto voi epäonnistua sisäänkirjautumisen ruuhka-aikoina.
TapahtumaluetteloTapahtumatyypit, hyötekuormat, järjestys ja toimituksen varmuus.Auditointi ja ilmoitusominaisuudet riippuvat luotettavista tapahtumista.
Integrointityönkulku

Integrointiprojektin toteutus viidessä vaiheessa

  1. Määritä tunnistemalliKartoi, kuka vastaanottaa koodeja, ekeys-kokeja tai kortteja ja miten ne vanhenevat.
  2. Hanki dokumentaatio ja hiekkaympäristöTarkista API-viittaus, käyttöoikeudet ja SDK:n esimerkkisovellukset etukäteen.
  3. Rakenna testilaitteita vastenKehitä nimettyjä lukkomalleja vasten, älä yleisten markkinointiväitteiden perusteella.
  4. Testaa virhetietSimuloi offline-lukot, päällekkäiset webhookit, tunnusten vanheneminen ja pyyntöraja-arvot.
  5. Pilotoi ja skaalaa sittenToteuta yksi rakennus tai hotellin kerros ennen koko laivajon julkaisua.
UKK

Kysymyksiä älylukkojen API:sta ja SDK:sta

Mitä eroa on älylukon API:lla ja SDK:lla?

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ä.

Voiko varausjärjestelmämme lähettää automaattisesti koodin jokaista varoitusta varten?

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ä.

Onko turvallista antaa sovelluksen avata ovia etä-API:n kautta?

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.

Takaavatko webhookit, että saatte kaikki ovitapahtumat?

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.

Kuka voi käyttää API:ta: brändi, tehdas vai loppuasiakas?

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ä.

Kehitätkö ohjelmistoa älylukkojen laitteistoille?

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 yleiskatsaus

Viimeksi päivitetty: 31. lokakuuta 2026 · Smart Lock Factoryn toimituskunnan tarkastama

Ostoskorisi
Kokemuksesi tällä sivustolla paranee, kun sallit evästeet. Evästekäytännöt
Chat on WhatsApp