Absztrakt fejlesztői jelenet intelligens zárral, laptoppal és lebegő csomópont grafikákkal, amelyeket vékony kék fénycsíkok kapcsolnak össze egy sötét asztalon, hideg technikai megvilágítással, emberek és olvasható szöveg nélkül, logók nélkül
Technológia

Intelligens zárak API-k és SDK-k: hogyan nyitja ki valójában a szoftver az ajtókat

A zárak integrálása egy appba, PMS-be vagy épületplatformba két külön eszközkészlettel történik: felhőalapú API-k a távoli műveletekhez, illetve Bluetooth SDK-k a közeli telefonvezérléshez. Ezek összekeverése az integráció megtervezésének leggyakoribb hibája.

Amikor egy harmadik fél alkalmazásnak kell intelligens zárakat működtetnie — például egy bérbeadási csatornának kódokat kell kiadnia, egy irodai platformnak látogatókat kell regisztrálnia, vagy egy szállodai appnak mobilkulcsokat kell kézbesítenie —, a zárgyártó programozható interfészeket tesz elérhetővé két rétegben. A felhőalapú API jellemzően REST-alapú szolgáltatás HTTPS-en keresztül: az alkalmazás OAuth-szerű hitelesítő adatokkal azonosítja magát, létrehozza a jelszámokat vagy e-kulcsokat, távoli feloldási parancsokat küld az online záraknak, lekérdezi a zár állapotát, és webhook-visszahívásokat kap a feloldás, az alacsony akkumulátorszint és a manipulálási események jelzésére. A mobil SDK olyan könyvtár, amelyet az integrátor saját iOS- vagy Android-appjába ágyaznak be; kezeli a Bluetooth-felderítést, a biztonságos kapcsolatot, a közeli feloldást és az offline hitelesítőadat-logikát anélkül, hogy vissza kellene fordulnia egy kiszolgálóhoz. A sikeres integrációk szándékosan mindkét réteget használják, biztonságban tartják a hitelesítő adataikat, és az üzembe helyezés előtt tesztelik a sebességkorlátokat és az eseménykézbesítést. Ez az útmutató bemutatja a fontos fogalmakat és gyártói kérdéseket. Az egyes platformok API- és SDK-elérhetőségét, hatókörét és licencelését az árajelzésenként írásban erősítjük meg.

Alapvető tudnivalók

API-k és SDK-k egy pillantásra

Felhőalapú APIA HTTPS-szolgáltatások szerverről kezelik a zárakat, a hitelesítő adatokat és az eseményeket; a távoli ajtókat csak akkor érik el, ha a zárak Wi-Fi-n vagy átjáróon keresztül online állapotban vannak.
Mobil SDKA beágyazott iOS-/Android-könyvtárak kezelik a Bluetooth-kapcsolatot, a közeli feloldást és az offline logikát az integrátor saját appján belül.
HitelesítésAz OAuth-szerű klienshitelesítő adatok, a korlátozott jogosultságú tokenek és az aláírt webhookok elkülönítik a professzionális platformokat a nyílt reléparancsfájloktól.
API-nkénti hitelesítő adatokA gyakori műveletek időben lejáró jelszámokat, e-kulcsokat, kártyákat és látogatói hivatkozásokat hoznak létre, valamint listázási, frissítési és visszavonási végpontokat kínálnak.
EseménykézbesítésA webhookok értesítik a feloldást, a kódhasználatot, az alacsony akkumulátorszintet és az ajtóeseményeket; az újrapróbálkozási viselkedést és a sorrendi garanciákat dokumentálni kell.
HardverfüggőségA távoli parancsok csak a Wi-Fi-n vagy átjáróon keresztül online zárakon hajthatók végre, ezért az API kialakítását és a hardver topológiáját együtt kell megtervezni.
SzabályzatunkInterfész-dokumentációt, sandboxot vagy teszteszközöket és technikai kapcsolattartót biztosítunk; a produkciós hitelesítő adatok és korlátok a platformmegállapodásból származnak.
Döntési egység

Mely integrációs útvonalra van szüksége a projektnek?

A kiszolgálóoldali automatizálás (bérbeadási csatornák, PMS, látogatókezelés) a felhőalapú API-ra épül; a közeli vagy offline vezérlést biztosító, márkázott telefonappokhoz mobil SDK szükséges. Mindkettőt igénylő termékeknél a hitelesítőadat-modellt a kódírás előtt kell megtervezni.

Integrációs célElsődleges eszközkészletFontos függőség
Időben lejáró bérbeadási kódok kiadásaFoglalási backend által használt felhőalapú APIA zárak támogatják a célzott kódtípust és a szinkronizálási útvonalat.
Márkázott bérlői appMobil SDK és felhőalapú APIAz appcsapat kezeli az SDK kiadását és az áruház jóváhagyását.
Szállodai mobilkulcs-kézbesítésA PMS köztes rétegén keresztül érkező felhőalapú API-eseményekHitelesítőadat-szolgáltatás és átjáróellátottság az ajtóknál.
Látogatókezelő kioskFelhőalapú API egyszer használatos hitelesítő adatokhozAz időzónák és a lejárási szemantika korai validálása szükséges.
Élő távoli recepciós szolgáltatásFelhőalapú API feloldás és webhook-visszaigazolásCsak az online zárak hajtják végre azonnal a távoli parancsokat.
Offline vállalati pénztárcaMobil SDK biztonságos helyi hitelesítő adatokkalA kulcstárolási és visszavonási szabályok az eszközön érvényesek.
Alkalmazási területek

Projektek, termékek és bizonyítékok

Az API-k az ajtónyitásnál találkoznak a fizikai valósággal: az átjárók, a fémajtók és az akkumulátor Terhelése határozza meg, hogy a tiszta API-hívás időben eléri-e a zárat. A pilot hardvert és szoftvert együtt kell kipróbálni.

AjtónyitásSzokásos ajtóZár megközelítése
Bérbeadási egység ajtajaBluetooth-zár területenkénti átjáróvalA foglalási backend a felhőalapú API-n keresztül offline és online kódokat hoz létre.
Irodai üvegentranceOnline olvasó vagy vezérlőA látogatói platform egyszer használatos hitelesítő adatokat küld, és belépési webhookokat kap.
Szállodai vendégszobaRFID-zár mobilkulcs-szolgáltatássalA PMS köztes rétege meghívja a kulcs-API-t; az átjáró valós idejű frissítéseket továbbít.
közös munkahely ajtajaIntelligens zár üvegfelület mögöttA tagsági app beágyazza az SDK-t a közeli feloldáshoz még gyenge Wi-Fi esetén is.
Logisztikai kapuKültéri online zárA távoli parancsokhoz megerősített kapcsolat és tartalék érintkezési mód szükséges.
Szolgáltatási helyiségTávolról kezelt akkumulátoros zárA webhookok naplózási adatai segítik a számlázást és a visszaélésvizsgálatot az üzemeltető appban.
Dokumentációs csomag

Integrációs előkészítő csomag

A prezentációkban az API-k hasonlóak, a produkcióban azonban különböznek. Mielőtt a mérnöki idő ráfordítását elköteleznék, az integrátoroknak össze kell gyűjteniük az alábbi elemeket, amelyek összehangolásában a platformcsapattal segítünk.

ÖsszetevőSzokásos logikaMegjegyzések
API-referenciaVégpontok, hatókörök, verziók és sandbox-elérhetőség.A mérnöki becslések a teljes, aktuális dokumentációtól függenek.
SDK-csomagTámogatott operációs rendszerverziók, mintaappok és kiadási ütemezés.Az áruházjóváhagyási és karbantartási modelleket meg kell érteni.
Biztonsági modellToken típusok, titkok rotációja, webhook-aláírás és IP-beállítások.A feloldási végpontok védelme produkcióban nem tárgyalható.
Korlátok és kvótákSebességkorlátok, lapozás, kötegelt műveletek és újrapróbálkozási szabályok.A flottabevezetések ellenére a csúcsidőszakokban a bejelentkezési órákban csúcsokon fordulhatnak elő.
EseménykatalógusEseménytípusok, hasznos teheradatok, sorrend és újrakézbesítési garanciák.A naplózási és értesítési funkciók megbízható eseményektől függenek.
Integrációs munkafolyamat

Az integrációs projekt öt lépésben

  1. A hitelesítőadat-modell meghatározásaTérképezze fel, kinek jut kód, e-kulcs vagy kártya, és hogyan járnak le.
  2. Dokumentáció és sandbox beszerzéseElőször tekintse át az API-referenciát, a hatóköröket és az SDK-mintaappokat.
  3. Fejlesztés teszteszközökkelNe általános marketingállításokra, hanem konkrét zármodellekre fejlesszen.
  4. Hibakezelési utak teszteléseSzimulálja az offline zárakat, a duplázott webhookokat, a token lejáratát és a sebességkorlátokat.
  5. Pilot, majd skálázásVégezzen próbaüzemet egy épületben vagy egy szállodai emeleten a teljes flottára történő bevezetés előtt.
Kapcsolódó technológiai útmutatók

API-khoz kapcsolódó integrációs és platformútmutatók

GYIK

Kérdések az intelligens zárak API-jairól és SDK-jairól

Mi a különbség az intelligens zár API-ja és az SDK között?

Az API szerver–szerver interfész: a háttérrendszer HTTPS-en keresztül kommunikál a zárplatformmal kódok létrehozására, nyitási parancsok küldésére az online zárakhoz, állapot lekérdezésére, valamint webhook-események fogadására, és a telefonk proximityjétől függetlenül működik. A mobil SDK olyan szoftverkönyvtár, amelyet a saját iOS- vagy Android-alkalmazásba építhet, és amely közvetlenül Bluetoothen keresztül kommunikál a zárakkal, így lehetővé teszi a közeli nyitást, a beállítást és a hitelesítő adatok offline tárolását, ha nincs elérhető szerver. A bérbeadási háttérrendszerek és a PMS-integrációk főként a felhőalapú API-t igénylik; a márkás bérlőalkalmazásokhoz általában az SDK és bizonyos API-hívások is szükségesek. Ha mindent az API-n keresztül szeretnénk elvégezni – például egy csak Bluetoothes zárat a világ másik feléről, gateway nélkül nyitni –, az egyszerűen nem működik, ezért a hardvertopológiát és az interfészválasztást együtt kell megtervezni. Az egyes platformoknál elérhető interfészeket az árajánlatban írásban erősítjük meg.

Foglalási platformunk automatikusan küldhet kódot minden foglaláshoz?

Igen, ez egy szokásos integrációs minta: a foglalás megerősítésekor a háttérrendszer vagy a köztes réteg meghívja a zárplatform API-ját a szobával vagy egységgel, az érkezés és távozás időpontjával, majd kódot vagy ekeyt kap, amelyet a saját üzenet- vagy e-mail-sablonunkon keresztül juttatunk el a vendégnek. A webhookek随后 megerősítik a használatot, és jelzik az olyan eseményeket, mint a korai bejelentkezési kísérletek vagy az alacsony töltöttségű akkumulátorok. Rögzítendő az időzónák kezelése a dátumtartományokhoz, az offline működéshez használható kódtípus az adott zárakon, a gatewayek lefedettsége az azonnali érvénytelenítéshez, az idempotens újrapróbálkozások az újraküldött üzeneteknél, valamint az, hogyan frissítik a lemondások és dátumváltoztatások a hitelesítő adatot. Tesztzárakat biztosítunk, és támogatjuk az integrációs műhelyeket; a végpontok részleteit, az átviteli korlátokat és a licencelési feltételeket minden platform esetében az árajánlatban erősítjük meg írásban.

Biztonságos-e, ha egy alkalmazás API-n keresztül távolról nyithatja az ajtókat?

A távoli nyitás akkor biztonságos, ha a platform bármely hitelesített pénzügyi API-hoz hasonlóan van felépítve: OAuth-szerű tokenek korlátozott hatókörökkel, kliensoldali titoktárolás, személyenkénti jogosultságok, parancsmegerősítés webhookon keresztül, naplózás, valamint opcionális kétfaktoros jóváhagyás az érzékeny ajtókhoz. Akkor válik veszélyessé, ha az integrátorok hosszú életű titkokat ágyaznak be a telefonos alkalmazásokba, nyitott relé-végpontokat tesznek közszolgálatra, vagy naplózzák a nyitási URL-eket. A fizikai biztonsági intézkedések is fontosak: a távoli parancsok csak az online zárakhoz jutnak el, a magas biztonsági szintű ajtóknál pedig gyakran teljesen letiltják a távoli nyitást, vagy kettős jóváhagyást írnak elő. A vizsgálat során kérje a biztonsági whitepaper-t, a tokenforgatási eljárást és a webhook-aláírási sémát, ne pedig fogadjon el egy puszta „REST API available” állítást. Ezeket a felülvizsgálatokat a platformcsapattal közösen szervezzük, és javasolhatunk olyan architektúrát, amelyben a távoli nyitás csak a recepciós szerepkörökre korlátozódik.

A webhookek garantálják, hogy minden ajtóeseményt megkapunk?

A webhookek a standard eseménycsatornák – nyitási naplók, kódbejegyzések, alacsony töltöttség, manipulációs riasztások és ajtóérzékelő-változások –, de az átvitel szemantikája platformonként eltér. A professzionális platformok aláírt adatokat küldenek, a sikertelen átviteleket pedig backoffal újrapróbálkozva ismétlik, és API-t biztosítanak a kimaradt események egyeztetésére vagy lekérdezésére. Ez azért fontos, mert a hálózatok időszakosan meghibásodnak, a duplikált kézbesítés pedig normális; a fogyasztóknak ezért az eseményazonosítókat idempotensként kell kezelniük. A sorrendre vonatkozó garanciák gyengébbek: két, egymástól néhány másodpercre keletkezett esemény időnként fordított sorrendben érkezhet, ezért az auditlogikának a záreseménye időbélyegéből kell kiindulnia, nem az érkezési időből. A próbaüzem során szimuláljon egy offline fogadót, és ellenőrizze az újrajátszási viselkedést. A rendezett platform eseménykatalógusát, újrapróbálkozási szabályait és egyeztetési végpontjait a fejlesztés megkezdése előtt írásban dokumentáljuk.

Ki használhatja az API-t: a márka, a gyár vagy a végfelhasználó?

Az API-hozzáférést a zárplatform saját fejlesztői és kereskedelmi feltételei alapján adja ki, jellemzően a fióktulajdonosnak: vagyis annak a márkának vagy üzemeltetőnek, amelyik a felhőprojektet birtokolja, nem pedig automatikusan minden zárvásárlónak. A gyár segíthet a szolgáltatás bekapcsolásában, a dokumentáció biztosításában és a technikai onboarding koordinálásában, de nem adhat a platformi megállapodáson túlmut jogosultságokat. Egyes platformok megkülönböztetnek csak alkalmazást használó felhasználókat, vezérlőpultokkal rendelkező üzleti fiókokat, valamint teljes API-hozzáféréssel rendelkező minősített fejlesztői partnereket, és néhány fejlett végpont használatához jóváhagyott integrációs vizsgálatra van szükség. A mély integrációt tervező vásárlók ezért a hardver kiválasztása előtt erősítsék meg a fejlesztői jogosultságot, a díjakat, az adatkezelési feltételeket és a támogatott régiókat, mert egy kiváló zár API-jogosultság nélkül nem tudja működtetni a tervezett terméket. Az aktuális fejlesztői programokat és az egyes platformok licencelési feltételeit az RFQ alapján erősítjük meg.

Fejleszt szoftvert intelligens zárhardverhez?

Az RFQ-ben adja meg integrációs felhasználási eseteit, csapatának technológiai környezetét és bevezetési ütemtervét. Koordináljuk az API-dokumentációt, az SDK-csomagokat, a teszteszközöket és a platformmegállapodásokat, valamint támogatjuk a közös próbaüemet, amely az offline működést, az újrapróbálkozásokat és a nagy flottaméretű eseményeket is lefedi.

Specifikációs lap és ajánlat kéréseTechnológiai áttekintés

Utoljára frissítve: 2026. október 31. · Felülvizsgálta a Smart Lock Factory szerkesztői csapata

Kosár
A cookie-k engedélyezésével javítható a felhasználói élmény ezen a weboldalon. Cookie-szabályzat
Chat on WhatsApp