
Integrering av låser i en app, PMS eller bygningsplattform skjer gjennom to distinkte verktøysett: sky-API-er for fjernoperasjoner og Bluetooth SDK-er for mobilstyring i nærheten. Å forveksle dem er den vanligste planleggingsfeilen ved integrering.
Når en tredjepartsapplikasjon skal betjene smartlåser — en utleiekanal som utsteder koder, en kontorplattform som provisionerer besøkende eller en hotellapp som leverer mobilnøkler — eksponerer låseleverandøren programmerbare grensesnitt i to lag. Sky-API-en er vanligvis en REST-basert tjeneste over HTTPS: applikasjonen autentiserer med OAuth-baserte legitimasjonsopplysninger, oppretter adgangskoder eller e-nøkler, sender fjernopplåsingskommandoer for nettbaserte låser, spør om låstatus og mottar webhook-tilbakemeldinger for opplåsing, lavt batteri og manipulasjonshendelser. Mobil-SDK-en er et bibliotek som er bygd inn i integratorens egen iOS- eller Android-app og håndterer Bluetooth-discovery, sikker tilkobling, opplåsing i nærheten og offline-logikk for legitimasjonsopplysninger uten å måtte gå via en server. Vellykkede integreringer bruker begge lagene bevisst, sikrer legitimasjonsopplysningene og tester grenseverdier og hendelseslevering før lansering. Denne veiledningen kartlegger begrepene og leverandørspørsmålene som betyr noe. Tilgjengelighet, omfang og lisensiering for API og SDK for hver plattform bekreftes skriftlig for hvert tilbud.
| Sky-API | HTTPS-tjenester administrerer låser, legitimasjonsopplysninger og hendelser fra en server; når bare fjerne dører når låsene er tilkoblet via Wi-Fi eller en gateway. |
| Mobil-SDK | Innbygde iOS/Android-biblioteker håndterer Bluetooth-tilkobling, opplåsing i nærheten og offline-logikk i integratorens egen app. |
| Autentisering | OAuth-baserte klientlegitimasjonsopplysninger, scopes, tokens og signerte webhooks skiller profesjonelle plattformer fra åpne relé-skripter. |
| Legitimasjonsopplysninger per API | Vanlige operasjoner oppretter tidsbegrensede adgangskoder, e-nøkler, kort og besøkslenker, med endepunkter for liste, oppdatering og tilbakekalling. |
| Hendelseslevering | Webhooks varsler om opplåsing, kodebruk, lavt batteri og dørhendelser; oppførsel ved nytt forsøk og ord GARANTIER må dokumenteres. |
| Maskinvareavhengighet | Fjernkommandoer utføres bare på tilkoblede låser via Wi-Fi eller en gateway, så API-design og maskinvaretopologi må planlegges sammen. |
| Vår policy | Vi tilbyr grensesnittdokumentasjon, sandbox eller testenheter og en teknisk kontakt; produksjonslegitimasjonsopplysninger og begrensninger kommer fra plattformavtalen. |
Serverbasert automatisering (utleiekanaler, PMS, besøkshåndtering) bygger på sky-API-en; merkevaretelefonapper med styring i nærheten eller offline legger til mobil-SDK-en. Produkter som trenger begge deler bør utforme modellen for legitimasjonsopplysninger før de skriver kode.
| Integreringsmål | Primært verktøysett | Viktigste avhengighet |
|---|---|---|
| Utstede tidsbegrensede utleiekoder | Sky-API fra booking-backend | Låsene støtter ønsket kodetype og synkroniseringsvei. |
| Merkevareapp for leietakere | Mobil-SDK pluss sky-API | Appteamet håndterer SDK-utgivelser og butikkgodkjenning. |
| Levering av mobilnøkler på hotell | Sky-API-hendelser fra PMS-mellomvare | Dekning for legitimasjonstjenester og gateway ved dørene. |
| Kiosk for besøkshåndtering | Sky-API for engangskredensialer | Tidssoner og utløpssemantikk valideres tidlig. |
| Direkte fjernbetjent concierge | Opplåsing via sky-API og bekreftelse via webhook | Bare tilkoblede låser utfører fjernkommandoer umiddelbart. |
| Offline lommebok for virksomheter | Mobil-SDK med sikrede lokale legitimasjonsopplysninger | Regler for nøkkeloppbevaring og tilbakekalling på enheten. |
API-er møter den fysiske virkeligheten ved åpningen: gateways, metalldører og batteribehov avgjør om et rent API-kall når låsen i tide. Pilotér maskinvare og programvare sammen.
| Åpning | Typisk dør | Låsetilnærming |
|---|---|---|
| Dør til utleieenhet | Bluetooth-lås med gateway per område | Booking-backenden oppretter offline- og onlinekoder via sky-API-en. |
| Glassinngang på kontor | Nettbasert leser eller kontroller | Besøksplattformen sender engangskredensialer og mottar webhooks for adgang. |
| Hotellgjest rom | RFID-lås med tjeneste for mobilnøkler | PMS-mellomvaren kaller nøkkel-API-en; gatewayen sender oppdateringer i sanntid. |
| Dør til coworking | Smartlås bak en glassfasade | Medlemsappen bruker SDK-en for opplåsing i nærheten, selv med svak Wi-Fi. |
| Logistikkport | Nettbasert lås utendørs | Fjernkommandoer krever bekreftet tilkobling og reservekontakter. |
| Fasilitetsrom | Batteridrevet lås som administreres eksternt | Webhooks gir revisjonsspor for fakturering og kontroll av misbruk i operatørappen. |
API-er ser like ut i presentasjoner, men er forskjellige i produksjon. Før de binder opp utviklingstid bør integratorene samle inn punktene nedenfor, og vi hjelper til med å koordinere dem med plattformteamet.
| Komponent | Typisk logikk | Merknader |
|---|---|---|
| API-referanse | Endepunkter, scopes, versjoner og sandbox-tilgjengelighet. | Utviklingsestimater avhenger av komplett og oppdatert dokumentasjon. |
| SDK-pakke | Støttede OS-versjoner, eksempelapper og utgivelseskadanse. | Butikkgodkjenning og vedlikeholdsmodeller må forstås. |
| Sikkerhetsmodell | Token-typer, hemmelighetsrotasjon, webhook-signering og IP-alternativer. | Beskyttelse av opplåsingsendepunkter er ikke til forhandling i produksjon. |
| Grenseverdier og kvoter | Hastighetsbegrensninger, paginering, batchoperasjoner og regler for nytt forsøk. | Uten disse kan lansering av en flåte feile i travle inncheckingsperioder. |
| Hendelseskatalog | Hendelsestyper, nyttelast, rekkefølge og garantier for ny levering. | Revisjons- og varslingsfunksjoner avhenger av pålitelige hendelser. |
En API er et server-til-server-grensesnitt: Backendløsningen din kommuniserer med låsplattformen over HTTPS for å opprette koder, sende opplåsningskommandoer til tilkoblede lås, hente status og motta webhook-hendelser, og det fungerer uavhengig av telefonens nærhet. En mobil SDK er et programvarebibliotek som er bygd inn i din egen iOS- eller Android-app og som kommuniserer direkte med lås over Bluetooth. Dette muliggjør opplåsning i nærheten, konfigurasjon og lagring av legitimasjon offline når ingen server er tilgjengelig. Utleiebackends og PMS-integrasjoner trenger hovedsakelig sky-API-en, mens merkevarebaserte tenant-apper vanligvis trenger SDK-en og utvalgte API-kall. Å prøve å gjøre alt gjennom API-en — for eksempel å låse opp et Bluetooth-lås fra den andre siden av verden uten gateway — vil ganske enkelt ikke fungere. Derfor må maskinvaretopologien og grensesnittvalset designes sammen. Tilgjengelige grensesnitt for hver plattform bekreftes skriftlig i hvert tilbud.
Ja, dette er et standard integrasjonsmønster: Når en bestilling er bekreftet, kommuniserer backendløsningen eller mellomvaren din med låsplattformens API og oppgir rom eller enhet, ankomst og avreise. Du mottar deretter en adgangskode eller ekey som leveres til gjesten via din egen meldings- eller e-postmal. Webhooks bekrefter deretter bruk og markerer hendelser som tidlig innsjekkingsforsøk eller lavt batterinivå. Kravene som må avklares, omfatter tidssonehåndtering for datointervaller, hvilken kodetype som fungerer offline på de valgte låsene, gateway-dekning for sanntidsinvalidering, idempotente forsøk når meldinger sendes på nytt, og hvordan avbestillinger og endringer i datoer oppdaterer legitimasjonen. Vi leverer testlås og støtter integrasjonsverksteder. Endpointdetaljer, hastighetsbegrensninger og lisensiering for hver plattform bekreftes skriftlig i hvert tilbud.
Fjernopplåsning er trygt når plattformen er bygget som en annen autentisert finansiell API: OAuth-lignende tokens med begrensede tillatelser, lagring av hemmeligheter på serversiden, tillatelser per ansatt, bekreftelse av kommandoer via webhook, revisjonslogger og valgfri tofaktorgodkjenning for sensitive dører. Det blir farlig når integratorer legger inn langlivede hemmeligheter i telefonapper, eksponerer åpne relay-endepunkter eller logger opplåsnings-URL-er. Fysiske sikkerhetstiltak er også viktige: Fjernkommandoer når bare tilkoblede lås, og dører med høy sikkerhet deaktiverer ofte fjernopplåsning helt eller krever dobbelt godkjenning. Under due diligence bør du be om sikkerhetsrapporten, prosedyren for tokenrotasjon og ordningen for webhook-signering i stedet for å godta påstanden «REST API tilgjengelig». Vi koordinerer slike gjennomganger med plattformteamet og kan foreslå arkitekturer der fjernopplåsning er begrenset til resepsjonsroller.
Webhooks er standardkanalen for hendelser — opplåsningsregistreringer, kodeinnganger, lavt batterinivå, sableringsvarsler og endringer i dørsensorer — men leveringssemantikken varierer mellom plattformer. Profesjonelle plattformer signerer nyttelastene, prøver på nytt mislykkede leveringer med økende ventetid og tilbyr en API for å avstemme eller hente inn hendelser som ble utelatt. Dette er viktig fordi nettverk kan svikte kortvarig og duplikatt levering er normalt. Mottakere må derfor håndtere hendelses-ID-er idempotent. Garantiene for rekkefølge er svakere: To hendelser som genereres noen sekunder fra hverandre kan av og til komme i omvendt rekkefølge. Revisjonslogikken bør derfor tidsstemple basert på hendelsestidspunktet hos låsen, ikke ankomsttidspunktet. Under pilotfasen bør du simulere en offline mottaker og verifisere atferden ved avspilling. Hendelseskatalogen, policyen for nye forsøk og avstemmingsendepunktene for den aktuelle plattformen dokumenteres skriftlig før utviklingen begynner.
API-tilgang gis av låsplattformen under plattformens egne utvikler- og forretningsvilkår, vanligvis til kontoeieren: Merket eller operatøren som eier skyprosjektet, ikke automatisk til alle som kjøper et lås. Fabrikken kan bidra til å aktivere tjenesten, levere dokumentasjon og koordinere teknisk onboarding, men kan ikke tildele rettigheter utover plattformavtalen. Enkelte plattformer skiller mellom brukere som kun bruker apper, bedriftskontoer med dashbord og sertifiserte utviklerpartnere med full API-tilgang. Noen avanserte endepunkter krever godkjent integrasjonsgjennomgang. Kjøpere som planlegger dypt integrerte løsninger bør derfor bekrefte utviklerberettigelse, kostnader, vilkår for databehandling og støttede regioner før de velger maskinvare, fordi et svært godt lås uten API-rettigheter ikke kan drive det planlagte produktet. Gjeldende utviklerprogrammer og lisensiering per plattform bekreftes for hver RFQ.
Del integrasjonsbruk, teamets teknologistikk og lanseringstidsplan med RFQ-en din. Vi koordinerer API-dokumentasjon, SDK-pakker, testenheter og plattformavtaler og støtter et felles pilotprosjekt som dekker offline-drift, nye forsøk og hendelser i storskala.
Be om spesifikasjonsark og tilbudTeknologioversiktSist oppdatert: 31. oktober 2026 · Gjennomgått av den redaksjonelle teamet til Smart Lock Factory