Abstrakt utvecklarscen med ett smartlås, en bärbar dator och gränssnittsnodsgrafik som är sammanlänkad av tunna blå ljusspår på ett mörkt skrivbord, sval teknisk belysning, inga personer, ingen läsbar text, inga logotyper
Teknik

API:er och SDK:er för smartlås: hur programvara faktiskt öppnar dörrar

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.

Nyckelfakta

API:er och SDK:er i korthet

Moln-APIHTTPS-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 SDKInbäddade iOS-/Android-bibliotek hanterar Bluetooth-anslutning, upplåsning inom räckvidd och offline-logik i integrerarens egen app.
AutentiseringOAuth-baserade klientuppgifter, avgränsade tokens och signerade webhooks skiljer professionella plattformar från öppna relayskript.
Behörighetsuppgifter per APIVanliga åtgärder omfattar att skapa tidsbegränsade lösenkoder, ekeys, kort och besökslänkar, med slutpunkter för listning, uppdatering och återkallelse.
HändelseleveransWebhooks meddelar om upplåsning, kodanvändning, lågt batteri och dörrhändelser; återförsöksbeteende och ordningsgarantier måste dokumenteras.
HårdvarberoendeFjä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 policyVi tillhandahåller gränssnittsdocumentation, en sandbox eller testenheter och en teknisk kontakt; produktionsuppgifter och gränser hämtas från plattformsavtalet.
Svarenhet

Vilken integrationsväg behöver ett projekt?

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ålPrimär verktygssuppsättningViktig beroendefaktor
Utfärda tidsbegränsade uthyrningskoderMoln-API från bokningsbackendLåsen stöder den avsedda kodtypen och synkvägen.
Märkt hyresgästappMobilt SDK plus moln-APIAppteamet hanterar SDK-versioner och granskning i appbutiken.
Leverans av mobila hotellnycklarMoln-API-händelser från PMS-middlewareBehörighetstjänst och gatewaytäckning vid dörrarna.
BesökshanteringskioskMoln-API för engångsbehörighetsuppgifterTidszoner och utgångslogik valideras tidigt.
Livefjärrstyrd conciergeMoln-API-upplåsning plus webhookbekräftelseEndast uppkopplade lås utför fjärrkommandon omedelbart.
Offline-företagsplånbokMobilt SDK med säkrade lokala behörighetsuppgifterRegler för nyckellagring och återkallelse på enheten.
Tillämpningsområden

Projekt, produkter och underlag

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.

ÖppningTypisk dörrLåsmetod
Dörr till uthyrningsenhetBluetoothlås med gateway per områdeBokningsbackend skapar offline- och onlinekoder via moln-API:et.
Glasingång till kontorUppkopplad läsare eller styrenhetBesöksplattformen skickar engångsbehörighetsuppgifter och tar emot webhooks för entré.
HotellgästrumRFID-lås med tjänst för mobila nycklarPMS-middleware anropar nyckel-API:et; gatewayn skickar liveuppdateringar.
Dörr till coworkingplatsSmartlås bakom en glast fasadMedlemsappen bäddar in SDK:et för upplåsning inom räckvidd även på svag Wi-Fi.
LogistikgrindUtomhuslås i uppkopplat lägeFjärrkommandon kräver bekräftad anslutning och reservkontakter.
FacilitetsrumBatterilås som hanteras på distansWebhookgranskningar driver fakturering och granskning av missbruk i operatörens app.
Dokumentationspaket

Paket för integrationsdue diligence

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.

KomponentTypisk logikAnteckningar
API-referensSlutpunkter, omfattning, versioner och tillgänglighet för sandbox.Uppskattningar från utvecklingen beror på fullständig och aktuell dokumentation.
SDK-paketOperativsystemversioner som stöds, exempelappar och versionscykel.Modeller för godkännande i appbutiken och underhåll måste förstås.
SäkerhetsmodellTokenstyper, rotation av hemligheter, webhooksignering och IP-alternativ.Skydd av upplåsningsslutpunkter är obligatoriskt i produktion.
Gränser och kvoterFrekvensgränser, paginering, batchåtgärder och regler för återförsök.Annars kan lanseringar av flera enheter misslyckas vid rusningstider med incheckningar.
HändelsedefinitionerHändelsetyper, nyttolast, ordning och garantier för omleverans.Funktioner för granskning och notifiering är beroende av tillförlitliga händelser.
Integrationsarbetsflöde

Så driver ni ett integrationsprojekt i fem steg

  1. Definiera modellen för behörighetsuppgifterKartlägg vem som får koder, ekeys eller kort och hur de upphör att gälla.
  2. Skaffa dokumentation och sandboxGranska API-referensen, omfattningen och SDK:ets exempelappar i förväg.
  3. Bygg mot testenheterUtveckla mot angivna låsmodeller, inte generella marknadsförsäkringar.
  4. Testa felvägarSimulera offline-lås, dubblerade webhooks, utgångna tokens och frekvensgränser.
  5. Pilotera och skala sedanKör i en byggnad eller på ett hotellvåningsplan innan lansering för hela enhetsflottan.
FAQ

Frågor om API:er och SDK:er för smarta lås

Vad är skillnaden mellan ett API och ett SDK för smarta lås?

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.

Kan vår bokningsplattform automatiskt skicka en kod för varje bokning?

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.

Är det säkert att låta en app låsa upp dörrar på distans via ett API?

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.

Garanterar webhooks att vi tar emot varje dörrhändelse?

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.

Vem kan använda API:et: varumärket, fabriken eller slutkunden?

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

Utvecklar du programvara för maskinvara för smarta lås?

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översikt

Senast uppdaterad: 31 oktober 2026 · Granskad av Smart Lock Factorys redaktionella team

Din kundvagn
Din upplevelse på denna webbplats förbättras om du tillåter cookies. Cookiepolicy
Chat on WhatsApp