
Integrering av lås i en app, ett PMS eller en byggplattform sker via två separata verktygssuppsättningar: moln-API:er för fjärrstyrda åtgärder och Bluetooth SDK:er för mobilstyrning inom räckvidd. Att förväxla dem är det vanligaste felet vid planering av integrationer.
När en tredjepartsapplikation behöver styra smartlås — en uthyrningskanal som utfärdar koder, en kontorsplattform som provisionerar besökare eller en hotellapp som levererar mobila nycklar — exponerar låstillverkaren programmerbara gränssnitt i två lager. Moln-API:et är vanligtvis en REST-baserad tjänst via HTTPS: applikationen autentiserar sig med OAuth-baserade uppgifter, skapar lösenkoder eller ekeys, skickar fjärrupplåsningskommandon för uppkopplade lås, frågar efter låsens status och tar emot webhook-återanrop för upplåsning, lågt batteri och manipulationshändelser. Det mobila SDK:et är ett bibliotek som är inbäddat i integrerarens egen iOS- eller Android-app och hanterar Bluetooth-identifiering, säker anslutning, upplåsning inom räckvidd och offline-logik för behörighetsuppgifter utan en tur och retur till en server. Lyckade integrationer använder båda lagren avsiktligt, skyddar sina uppgifter och testar gränser för frekvens och händelseleverans före lansering. Den här guiden kartlägger begreppen och de leverantörsfrågor som spelar roll. Tillgänglighet, omfattning och licensier för API:er och SDK:er för varje plattform bekräftas skriftligen i varje offert.
| Moln-API | HTTPS-tjänster hanterar lås, behörighetsuppgifter och händelser från en server; fjärrdörrar nås endast när låsen är uppkopplade via Wi-Fi eller en gateway. |
| Mobilt SDK | Inbäddade iOS-/Android-bibliotek hanterar Bluetooth-anslutning, upplåsning inom räckvidd och offline-logik i integrerarens egen app. |
| Autentisering | OAuth-baserade klientuppgifter, avgränsade tokens och signerade webhooks skiljer professionella plattformar från öppna relayskript. |
| Behörighetsuppgifter per API | Vanliga åtgärder omfattar att skapa tidsbegränsade lösenkoder, ekeys, kort och besökslänkar, med slutpunkter för listning, uppdatering och återkallelse. |
| Händelseleverans | Webhooks meddelar om upplåsning, kodanvändning, lågt batteri och dörrhändelser; återförsöksbeteende och ordningsgarantier måste dokumenteras. |
| Hårdvarberoende | Fjärrkommandon utförs endast på uppkopplade lås via Wi-Fi eller en gateway, så API-design och hårdvarutopologi måste planeras tillsammans. |
| Vår policy | Vi tillhandahåller gränssnittsdocumentation, en sandbox eller testenheter och en teknisk kontakt; produktionsuppgifter och gränser hämtas från plattformsavtalet. |
Serverbaserad automatisering (uthyrningskanaler, PMS, besökshantering) bygger på moln-API:et; märkta telefonappar med styrning inom räckvidd eller offline lägger till det mobila SDK:et. Produkter som behöver båda bör utforma modellen för behörighetsuppgifter innan kod skrivs.
| Integrationsmål | Primär verktygssuppsättning | Viktig beroendefaktor |
|---|---|---|
| Utfärda tidsbegränsade uthyrningskoder | Moln-API från bokningsbackend | Låsen stöder den avsedda kodtypen och synkvägen. |
| Märkt hyresgästapp | Mobilt SDK plus moln-API | Appteamet hanterar SDK-versioner och granskning i appbutiken. |
| Leverans av mobila hotellnycklar | Moln-API-händelser från PMS-middleware | Behörighetstjänst och gatewaytäckning vid dörrarna. |
| Besökshanteringskiosk | Moln-API för engångsbehörighetsuppgifter | Tidszoner och utgångslogik valideras tidigt. |
| Livefjärrstyrd concierge | Moln-API-upplåsning plus webhookbekräftelse | Endast uppkopplade lås utför fjärrkommandon omedelbart. |
| Offline-företagsplånbok | Mobilt SDK med säkrade lokala behörighetsuppgifter | Regler för nyckellagring och återkallelse på enheten. |
API:er möter den fysiska verkligheten vid öppningen: gateways, metalldörrar och batteridrift avgör om ett rent API-anrop når låset i tid. Pilotera hårdvara och programvara tillsammans.
| Öppning | Typisk dörr | Låsmetod |
|---|---|---|
| Dörr till uthyrningsenhet | Bluetoothlås med gateway per område | Bokningsbackend skapar offline- och onlinekoder via moln-API:et. |
| Glasingång till kontor | Uppkopplad läsare eller styrenhet | Besöksplattformen skickar engångsbehörighetsuppgifter och tar emot webhooks för entré. |
| Hotellgästrum | RFID-lås med tjänst för mobila nycklar | PMS-middleware anropar nyckel-API:et; gatewayn skickar liveuppdateringar. |
| Dörr till coworkingplats | Smartlås bakom en glast fasad | Medlemsappen bäddar in SDK:et för upplåsning inom räckvidd även på svag Wi-Fi. |
| Logistikgrind | Utomhuslås i uppkopplat läge | Fjärrkommandon kräver bekräftad anslutning och reservkontakter. |
| Facilitetsrum | Batterilås som hanteras på distans | Webhookgranskningar driver fakturering och granskning av missbruk i operatörens app. |
API:er ser likadana ut i presentationer men skiljer sig i produktion. Innan integrerare åtar sig utvecklingstid bör de samla in punkterna nedan, som vi hjälper till att samordna med plattformsteamet.
| Komponent | Typisk logik | Anteckningar |
|---|---|---|
| API-referens | Slutpunkter, omfattning, versioner och tillgänglighet för sandbox. | Uppskattningar från utvecklingen beror på fullständig och aktuell dokumentation. |
| SDK-paket | Operativsystemversioner som stöds, exempelappar och versionscykel. | Modeller för godkännande i appbutiken och underhåll måste förstås. |
| Säkerhetsmodell | Tokenstyper, rotation av hemligheter, webhooksignering och IP-alternativ. | Skydd av upplåsningsslutpunkter är obligatoriskt i produktion. |
| Gränser och kvoter | Frekvensgränser, paginering, batchåtgärder och regler för återförsök. | Annars kan lanseringar av flera enheter misslyckas vid rusningstider med incheckningar. |
| Händelsedefinitioner | Händelsetyper, nyttolast, ordning och garantier för omleverans. | Funktioner för granskning och notifiering är beroende av tillförlitliga händelser. |
Ett API är ett server-till-server-gränssnitt: din backend anropar låsplattformen via HTTPS för att skapa koder, skicka upplåsningskommandon till online-lås, hämta status och ta emot webhook-händelser. Det fungerar oavsett hur nära telefonen är. Ett mobil-SDK är ett programvarubibliotek som integreras i din egen iOS- eller Android-app och som kommunicerar direkt med lås via Bluetooth. Det möjliggör upplåsning i närheten, konfiguration och offline-lagring av behörighetsuppgifter när ingen server är tillgänglig. Uthyrningsbackends och PMS-integrationer behöver främst moln-API:et; varumärkesappar för uthyrare behöver vanligen SDK:et plus utvalda API-anrop. Att försöka göra allt via API:et — exempelvis att låsa upp ett endast Bluetooth-baserat lås från andra sidan världen utan en gateway — fungerar inte. Maskinvarans topologi och gränssnittsval måste därför utformas tillsammans. Tillgängliga gränssnitt per plattform bekräftas skriftligt i varje offert.
Ja, det är ett vanligt integrationsmönster: när en bokning bekräftas anropar din backend eller middleware låsplattformens API med rum ellerenhet, ankomst och avresa, och får tillbaka en åtkomstkod eller ekey som levereras till gästen via din egen meddelande- eller e-postmall. Webhooks bekräfter sedan användningen och markerar händelser som tidiga incheckningsförsök eller lågt batteri. Krav som måste preciseras är hantering av tidszoner för datumintervall, vilken kodtyp som fungerar offline på de valda låsen, gateway-täckning för liveåterkallelse, idempotenta återförsök när meddelanden skickas om samt hur avbokningar och datumändringar uppdaterar behörighetsuppgifterna. Vi tillhandahåller testlås och stödjer integrationsworkshops; information om endpoints, hastighetsbegränsningar och licensier för varje plattform bekräftas skriftligt i varje offert.
Upplåsning på distans är säker när plattformen är byggd som alla autentiserade finansiella API:er: OAuth-liknande tokens med begränsade behörighetsområden, serverbaserad lagring av hemligheter, behörigheter per personal, kommandobekräftelse via webhook, granskningsloggar och valfri tvåfaktorsgodkännande för känsliga dörrar. Risk uppstår när integratörer bäddar in långlivade hemligheter i telefonappar, exponerar öppna relay-endpoints eller loggar upplåsnings-URL:er. Fysiska säkerhetsåtgärder är också viktiga: fjärrkommandon når endast online-lås, och dörrar med hög säkerhet inaktiverar ofta upplåsning på distans helt eller kräver dubbelt godkännande. Vid due diligence bör du begära plattformens säkerhetsdokumentation, procedur för tokenrotation och signeringsmetod för webhooks i stället för att acceptera påståendet att ett “REST API finns tillgängligt”. Vi samordnar dessa granskningar med plattformsteamet och kan föreslå arkitekturer där upplåsning på distans begränsas till receptionistroller.
Webhooks är den vanliga händelsekanalen — upplåsningsposter, kodinmatningar, lågt batteri, sabotagevarningar och ändringar av dörrsensorer — men leveranssemantiken varierar mellan plattformar. Professionella plattformar signerar nyttolaster, försöker leverera om misslyckade leveranser med ökande väntetider och tillhandahåller ett API för att avstämma eller hämta missade händelser. Detta är viktigt eftersom nätverk ibland tillfälligt avbryts och dubbelleveranser är normalt; konsumenterna måste därför behandla händelse-ID:n som idempotenta. Ordninggarantierna är svagare: två händelser som genereras några sekunder isär kan ibland levereras i omvänd ordning. Granskningslogiken bör därför tidsstämplas utifrån händelsetiden i låset, inte leveranstiden. Under pilotfasen bör du simulera en offline-mottagare och verifiera beteendet vid uppspelning. Händisekatalogen, återförsökspolicyn och avstämningsendpoints för den aktuella plattformen dokumenteras skriftligt innan utvecklingen börjar.
Åtkomst till API:et beviljas av låsplattformen enligt dess egna utvecklar- och kommersiella villkor, vanligen till kontoägaren: varumärket eller operatören som äger molnprojektet, inte automatiskt till varje köpare av ett lås. Fabriken kan hjälpa till att aktivera tjänsten, tillhandahålla dokumentation och samordna teknisk onboarding, men kan inte tilldela rättigheter utöver plattformens avtal. Vissa plattformar skiljer mellan användare som endast använder appar, företagskonton med instrumentpaneler och certifierade utvecklingspartner med full API-åtkomst, medan vissa avancerade endpoints kräver en godkänd integrationsgranskning. Köpare som planerar djupa integrationer bör därför bekräfta utvecklarbehörighet, avgifter, villkor för databehandling och regioner som stöds innan de väljer maskinvara, eftersom ett utmärkt lås utan API-rättigheter inte kan driva den planerade produkten. Aktuella utvecklarprogram och licenser per plattform bekräftas i varje RFQ.
Berätta om dina integreringsbehov, teamets teknolog栈 och planerad lansering i din RFQ. Vi samordnar API-dokumentation, SDK-paket, testenheter och plattformsavtal och stödjer ett gemensamt pilotprojekt som omfattar offline, återförsök och händelser i storskalig driftsättning.
Beställ datablad + offertTekniköversiktSenast uppdaterad: 31 oktober 2026 · Granskad av Smart Lock Factorys redaktionella team