
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.
| Felhőalapú API | A 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 SDK | A 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és | Az 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ő adatok | A 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és | A 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ég | A 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ályzatunk | Interfé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. |
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él | Elsődleges eszközkészlet | Fontos függőség |
|---|---|---|
| Időben lejáró bérbeadási kódok kiadása | Foglalási backend által használt felhőalapú API | A zárak támogatják a célzott kódtípust és a szinkronizálási útvonalat. |
| Márkázott bérlői app | Mobil SDK és felhőalapú API | Az appcsapat kezeli az SDK kiadását és az áruház jóváhagyását. |
| Szállodai mobilkulcs-kézbesítés | A PMS köztes rétegén keresztül érkező felhőalapú API-események | Hitelesítőadat-szolgáltatás és átjáróellátottság az ajtóknál. |
| Látogatókezelő kiosk | Felhőalapú API egyszer használatos hitelesítő adatokhoz | Az időzónák és a lejárási szemantika korai validálása szükséges. |
| Élő távoli recepciós szolgáltatás | Felhőalapú API feloldás és webhook-visszaigazolás | Csak az online zárak hajtják végre azonnal a távoli parancsokat. |
| Offline vállalati pénztárca | Mobil SDK biztonságos helyi hitelesítő adatokkal | A kulcstárolási és visszavonási szabályok az eszközön érvényesek. |
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ás | Szokásos ajtó | Zár megközelítése |
|---|---|---|
| Bérbeadási egység ajtaja | Bluetooth-zár területenkénti átjáróval | A foglalási backend a felhőalapú API-n keresztül offline és online kódokat hoz létre. |
| Irodai üvegentrance | Online 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égszoba | RFID-zár mobilkulcs-szolgáltatással | A 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 ajtaja | Intelligens zár üvegfelület mögött | A tagsági app beágyazza az SDK-t a közeli feloldáshoz még gyenge Wi-Fi esetén is. |
| Logisztikai kapu | Kültéri online zár | A távoli parancsokhoz megerősített kapcsolat és tartalék érintkezési mód szükséges. |
| Szolgáltatási helyiség | Távolról kezelt akkumulátoros zár | A webhookok naplózási adatai segítik a számlázást és a visszaélésvizsgálatot az üzemeltető appban. |
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 logika | Megjegyzések |
|---|---|---|
| API-referencia | Vé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-csomag | Tá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 modell | Token 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ák | Sebessé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ógus | Esemé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. |
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.
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.
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 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.
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.
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ésUtoljára frissítve: 2026. október 31. · Felülvizsgálta a Smart Lock Factory szerkesztői csapata