Abstrakt udviklerscene med en smart lock, bærbar computer og flydende grænseflodegrafik forbundet af tynde blå lysstriber på et mørkt skrivebord, kølig teknisk belysning, ingen personer, ingen læselig tekst, ingen logoer
Teknologi

API’er og SDK’er til smart locks: Sådan åbner software faktisk døre

Integration af låse i en app, et PMS eller en bygningsplatform sker gennem to forskellige værktøjssæt: cloud-API’er til fjernstyring og Bluetooth SDK’er til betjening fra en telefon i nærheden. At forveksle dem er den mest almindelige fejl i integrationsplanlægningen.

Når en tredjepartsapplikation skal betjene smart locks — en udlejningskanal, der udsteder koder, en kontorplatform, der tildeler besøgende adgang, eller en hotelapp, der leverer mobile nøgler — udstiller låseleverandøren programmerbare grænseflader i to lag. Cloud-API’en er typisk en REST-baseret tjeneste via HTTPS: Applikationen godkendes med OAuth-baserede legitimationsoplysninger, opretter adgangskoder eller ekeys, sender fjernkommandoer til oplåsning af online-låse, forespørger låsens tilstand og modtager webhook-callbacks ved oplåsning, lav batteristand og manipulation. Det mobile SDK er et bibliotek, der er indlejret i integratorens egen iOS- eller Android-app, og som håndterer Bluetooth-detektion, sikker forbindelse, oplåsning i nærheden og offline-håndtering af legitimationsoplysninger uden omveje via en server. Vellykkede integrationer bruger begge lag bevidst, sikrer deres legitimationsoplysninger og tester hastighedsbegrænsninger og hændelseslevering inden lancering. Denne vejledning kortlægger de centrale begreber og de leverandørspørgsmål, der betyder noget. Tilgængeligheden af API’er og SDK’er, tilladelsesområder og licensvilkår for hver platform bekræftes skriftligt i forbindelse med hvert tilbud.

Nøgletal

API’er og SDK’er i overblik

Cloud-APIHTTPS-tjenester administrerer låse, legitimationsoplysninger og hændelser fra en server;Fjernadgang til døre er kun mulig, når låsene er online via Wi-Fi eller en gateway.
Mobil SDKIndlejrede iOS-/Android-biblioteker håndterer Bluetooth-forbindelse, oplåsning i nærheden og offline-logik i integratorens egen app.
GodkendelseOAuth-baserede klientoplysninger, afgrænsede tokens og signerede webhooks adskiller professionelle platforme fra åbne relæscripts.
Legitimationsoplysninger pr. APIAlmindelige operationer opretter tidsbegrænsede adgangskoder, ekeys, kort og besøgslinks med endpoints til oplisting, opdatering og tilbagekaldelse.
HændelsesleveringWebhooks underretter om oplåsning, kodebrug, lav batteristand og dørhændelser; Retningslinjer for gentagne forsøg og rækkefølgegarantier skal dokumenteres.
HardwareafhængighedFjernkommandoer udføres kun på online-låse via Wi-Fi eller en gateway, så API-design og hardwaretopologi skal planlægges sammen.
Vores politikVi leverer grænsefladedokumentation, sandbox- eller testenheder samt en teknisk kontakt; Produktionslegitimationsoplysninger og begrænsninger kommer fra platformaftalen.
Svarenhed

Hvilken integrationsvej har et projekt brug for?

Serverbaseret automatisering (udlejningskanaler, PMS, besøgsstyring) bygger på cloud-API’en; Brandede telefonapps med betjening i nærheden eller offline tilføjer det mobile SDK. Produkter, der har brug for begge dele, bør designe legitimationsmodellen, før der skrives kode.

IntegrationsmålPrimært værktøjssætVigtig afhængighed
Udstedelse af tidsbegrænsede udlejningskoderCloud-API fra bookingbackendLåsene understøtter den ønskede kodetype og synkroniseringsvej.
Brandet lejerappMobil SDK plus cloud-APIAppteamet håndterer SDK-frigivelse og gennemgang i butikke.
Levering af mobile hotelnøglerCloud-API-hændelser fra PMS-middlewareDækning af legitimationsservice og gateway ved dørene.
Kiosk til besøgsstyringCloud-API til engangskredentialerTidszoner og betydning af udløb valideres tidligt.
Live fjernbetjent conciergeCloud-API-oplåsning plus webhook-bekræftelseKun online-låse udfører fjernkommandoer med det samme.
Offline virksomhedswalletMobil SDK med sikrede lokale legitimationsoplysningerRegler for nøglelagring og tilbagekaldelse på enheden.
Anvendelsesområder

Projekter, produkter og dokumentation

API’er møder den fysiske virkelighed, når døren åbnes: Gateways, metaldøre og batteribehov afgør, om et rent API-kald når låsen i tide. Test hardware og software sammen i en pilot.

ÅbningTypisk dørLåseindsats
LejenhedsdørBluetooth-lås med gateway pr. områdeBookingbackenden opretter offline- og onlinekoder via cloud-API’en.
Glask入口 til kontorOnline-læser eller controllerBesøgsplatformen sender engangskredentialer og modtager webhooks om adgang.
HotelgæsteværelseRFID-lås med tjeneste til mobile nøglerPMS-middlewareen kalder nøgle-API’en; Gatewayen sender opdateringer i realtid.
Co-working-dørSmart lock bag en glasfacadeMedlemsappen indlejrer SDK’en til oplåsning i nærheden, selv på svagt Wi-Fi.
LogistikportOutdoor online-låsFjernkommandoer kræver bekræftet forbindelse og fallback-kontakter.
FacilitetsrumBatteridrevet lås, der fjernstyresWebhooks giver revisionsspor til afregning og misbrugskontrol i driftappen.
Dokumentationspakke

Pakke til integrationens due diligence

API’er ligner hinanden i præsentationer, men adskiller sig i produktion. Før udviklingstiden bindes, bør integratorer indsamle nedenstående oplysninger, som vi hjælper med at koordinere sammen med platformteamet.

KomponentTypisk logikBemærkninger
API-referenceEndpoints, tilladelsesområder, versioner og tilgængelighed i sandbox.Tekniske estimater afhænger af fuldstændig og aktuel dokumentation.
SDK-pakkeUnderstøttede OS-versioner, eksempelapps og udgivelseskadence.Butiksgodkendelse og vedligeholdelsesmodeller skal forstås.
SikkerhedsmodelTokentyper, rotation af hemmeligheder, webhook-signering og IP-muligheder.Beskyttelse af oplåsningsendpoints er uforhandelig i produktion.
Begrænsninger og kvoterHastighedsbegrænsninger, paginering, batchoperationer og regler for gentagne forsøg.Uden disse kan lanceringer af større flåder fejle i perioder med mange indcheckninger.
HændelseskatalogHændelsestyper, dataindhold, rækkefølge og garantier for genlevering.Revisions- og underretningsfunktioner afhænger af pålidelige hændelser.
Integrationsworkflow

Sådan gennemføres et integrationsprojekt i fem trin

  1. Fastlæg legitimationsmodellenKortlæg, hvem der modtager koder, ekeys eller kort, og hvordan de udløber.
  2. Indhent dokumentation og sandboxGennemgå API-referencen, tilladelsesområderne og SDK’ens eksempelapps fra starten.
  3. Udvikl mod testenhederUdvikl mod konkrette låsmodeller, ikke generiske marketingpåstande.
  4. Test fejlscenarierSimulér offline-låse, duplicate webhooks, udløbne tokens og hastighedsbegrænsninger.
  5. Pilotér, og skaler derefterTest med én bygning eller én hoteletage før udrulning på tværs af hele flåden.
FAQ

Spørgsmål om API’er og SDK’er til smarte låse

Hvad er forskellen mellem et API og et SDK til smarte låse?

Et API er et server-til-server-interface: Din backend kalder låseplatformen via HTTPS for at oprette koder, sende oplåsningskommandoer til online-låse, hente status og modtage webhook-hændelser, og det fungerer uanset telefonens proximity. Et mobil-SDK er et softwarebibliotek, der indbygges i din egen iOS- eller Android-app og kommunikerer direkte med låsene via Bluetooth, hvilket muliggør oplåsning i nærheden, opsætning og offline-lagring af adgangskredentials, når ingen server er tilgængelig. Udlejnings-backends og PMS-integrationer har hovedsageligt brug for cloud-API’et; branded tenant-apps har normalt brug for SDK’en samt udvalgte API-kald. At forsøge at gøre alt via API’et — eksempelvis at låse en Bluetooth-only-lå op fra den anden side af jorden uden gateway — vil simpelthen ikke virke, så hardwaretopologien og grænsefladevalget skal designes sammen. Tilgængelige grænseflader for hver platform bekræftes skriftligt i tilbuddet.

Kan vores bookingplatform automatisk sende en kode for hver reservation?

Ja, det er et standardintegrationsmønster: Når en reservation bekræftes, kalder din backend eller middleware låseplatformens API med værelse eller enhed samt ankomst- og afrejsetid og modtager en adgangskode eller ekey, der leveres til gæsten via din egen besked- eller e-mailskabelon. Webhooks bekræfter derefter brugen og markerer hændelser som tidlig indcheckning eller lavt batteriniveau. De forhold, der skal afklares, er håndtering af tidszoner for datointervaller, hvilken kodetype der fungerer offline på de valgte låse, gateway-dækning til live-revocation, idempotent genforsøg, når beskeder sendes igen, og hvordan aflysninger og datoændringer opdaterer adgangskredentialet. Vi leverer testlåse og støtter integrationsworkshops; endpointdetaljer, hastighedsbegrænsninger og licensvilkår for hver platform bekræftes skriftligt i tilbuddet.

Er det sikkert at lade en app låse døre op fjernt via et API?

Fjernoplåsning er sikker, når platformen er bygget som et godkendt finansielt API med autentificering: OAuth-lignende tokens med begrænsede scopes, lagring af secrets på serversiden, tilladelser pr. medarbejder, kommandobekræftelse via webhook, auditlogs og valgfri tofaktorgodkendelse til følsomme døre. Det bliver farligt, når integratorer indlejrer langlivede secrets i telefonapps, eksponerer åbne relay-endpoints eller logger oplåsnings-URL’er. Fysiske sikkerhedsforanstaltninger er også vigtige: Fjernkommandoer når kun online-låse, og døre med høj sikkerhed deaktiverer ofte fjernoplåsning helt eller kræver dobbeltgodkendelse. Bed om sikkerhedsdokumentationen, proceduren for tokenrotation og webhook-signaturordning under due diligence i stedet for at acceptere påstanden »REST API available«. Vi koordinerer disse gennemgange med platformteamet og kan foreslå arkitekturer, hvor fjernoplåsning kun er tilladt for receptionister.

Garanterer webhooks, at vi modtager alle dørhændelser?

Webhooks er den standardmæssige hændelseskanal — oplåsningsposter, kodeindtastninger, lavt batteri, manipulationsalarmer og ændringer i dørsensorer — men leveringssemantikken varierer fra platform til platform. Professionelle platforme signerer payloads, genforsøger mislykkede leveringer med backoff og tilbyder et API til afstemning eller polling af manglende hændelser, hvilket er vigtigt, fordi netværk kortvarigt kan fejle, og dobbeltlevering er normalt; forbrugere skal derfor behandle hændelses-ID’er idempotently. Garantier for rækkefølge er svagere: To hændelser, der genereres få sekunder fra hinanden, kan lejlighedsvis ankomme i omvendt rækkefølge, så auditlogikken bør tidsstemples ud fra hændelsestidspunktet på låsen frem for ankomsttidspunktet. Simuler under pilotprojektet en offline-modtager, og verificér replay-adfærden. Hændelseskatalog, genforsøgspolitik og afstillingsendpoints for den valgte platform dokumenteres skriftligt, før udviklingen begynder.

Hvem kan bruge API’et: Brandet, fabrikken eller slutkunden?

API-adgang tildeles af låseplatformen under platformens egne udvikler- og forretningsvilkår, typisk til kontoejeren: Brandet eller driftsoperatøren, der ejer cloudprojektet, og ikke automatisk til enhver køber af en lås. Fabrikken kan hjælpe med at aktivere tjenesten, levere dokumentation og koordinere teknisk onboarding, men kan ikke tildele rettigheder ud over platformaftalen. Nogle platforme skelner mellem brugere med kun appadgang, virksomhedskonti med dashboards og certificerede udviklerpartnere med fuld API-adgang, og nogle avancerede endpoints kræver godkendt integrationsgennemgang. Købere, der planlægger dybe integrationer, bør derfor bekræfte udviklerberettigelse, gebyrer, vilkår for databehandling og understøttede regioner, før hardware vælges, fordi en fremragende lås uden API-rettigheder ikke kan drive det planlagte produkt. Aktuelle udviklerprogrammer og licensvilkår for hver platform bekræftes pr. RFQ.

Udvikler I software til hardware med smarte låse?

Del jeres integrationstilfælde, teamets teknologisti og lanceringstidsplan med RFQ’en. Vi koordinerer API-dokumentation, SDK-pakker, testenheder og platformaftaler og støtter et fælles pilotprojekt, der dækker offline drift, genforsøg og hændelser i stor skala.

Anmod om datablad + tilbudTeknioversigt

Sidst opdateret: 31. oktober 2026 · Gennemgået af Smart Lock Factory’s redaktionelle team

Din kurv
Din oplevelse på dette websted forbedres ved at tillade cookies Cookiepolitik
Chat on WhatsApp