
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.
| Cloud-API | HTTPS-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 SDK | Indlejrede iOS-/Android-biblioteker håndterer Bluetooth-forbindelse, oplåsning i nærheden og offline-logik i integratorens egen app. |
| Godkendelse | OAuth-baserede klientoplysninger, afgrænsede tokens og signerede webhooks adskiller professionelle platforme fra åbne relæscripts. |
| Legitimationsoplysninger pr. API | Almindelige operationer opretter tidsbegrænsede adgangskoder, ekeys, kort og besøgslinks med endpoints til oplisting, opdatering og tilbagekaldelse. |
| Hændelseslevering | Webhooks underretter om oplåsning, kodebrug, lav batteristand og dørhændelser; Retningslinjer for gentagne forsøg og rækkefølgegarantier skal dokumenteres. |
| Hardwareafhængighed | Fjernkommandoer udføres kun på online-låse via Wi-Fi eller en gateway, så API-design og hardwaretopologi skal planlægges sammen. |
| Vores politik | Vi leverer grænsefladedokumentation, sandbox- eller testenheder samt en teknisk kontakt; Produktionslegitimationsoplysninger og begrænsninger kommer fra platformaftalen. |
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ål | Primært værktøjssæt | Vigtig afhængighed |
|---|---|---|
| Udstedelse af tidsbegrænsede udlejningskoder | Cloud-API fra bookingbackend | Låsene understøtter den ønskede kodetype og synkroniseringsvej. |
| Brandet lejerapp | Mobil SDK plus cloud-API | Appteamet håndterer SDK-frigivelse og gennemgang i butikke. |
| Levering af mobile hotelnøgler | Cloud-API-hændelser fra PMS-middleware | Dækning af legitimationsservice og gateway ved dørene. |
| Kiosk til besøgsstyring | Cloud-API til engangskredentialer | Tidszoner og betydning af udløb valideres tidligt. |
| Live fjernbetjent concierge | Cloud-API-oplåsning plus webhook-bekræftelse | Kun online-låse udfører fjernkommandoer med det samme. |
| Offline virksomhedswallet | Mobil SDK med sikrede lokale legitimationsoplysninger | Regler for nøglelagring og tilbagekaldelse på enheden. |
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.
| Åbning | Typisk dør | Låseindsats |
|---|---|---|
| Lejenhedsdør | Bluetooth-lås med gateway pr. område | Bookingbackenden opretter offline- og onlinekoder via cloud-API’en. |
| Glask入口 til kontor | Online-læser eller controller | Besøgsplatformen sender engangskredentialer og modtager webhooks om adgang. |
| Hotelgæsteværelse | RFID-lås med tjeneste til mobile nøgler | PMS-middlewareen kalder nøgle-API’en; Gatewayen sender opdateringer i realtid. |
| Co-working-dør | Smart lock bag en glasfacade | Medlemsappen indlejrer SDK’en til oplåsning i nærheden, selv på svagt Wi-Fi. |
| Logistikport | Outdoor online-lås | Fjernkommandoer kræver bekræftet forbindelse og fallback-kontakter. |
| Facilitetsrum | Batteridrevet lås, der fjernstyres | Webhooks giver revisionsspor til afregning og misbrugskontrol i driftappen. |
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.
| Komponent | Typisk logik | Bemærkninger |
|---|---|---|
| API-reference | Endpoints, tilladelsesområder, versioner og tilgængelighed i sandbox. | Tekniske estimater afhænger af fuldstændig og aktuel dokumentation. |
| SDK-pakke | Understøttede OS-versioner, eksempelapps og udgivelseskadence. | Butiksgodkendelse og vedligeholdelsesmodeller skal forstås. |
| Sikkerhedsmodel | Tokentyper, rotation af hemmeligheder, webhook-signering og IP-muligheder. | Beskyttelse af oplåsningsendpoints er uforhandelig i produktion. |
| Begrænsninger og kvoter | Hastighedsbegræ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ændelseskatalog | Hændelsestyper, dataindhold, rækkefølge og garantier for genlevering. | Revisions- og underretningsfunktioner afhænger af pålidelige hændelser. |
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.
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.
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.
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.
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.
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 + tilbudTeknioversigtSidst opdateret: 31. oktober 2026 · Gennemgået af Smart Lock Factory’s redaktionelle team