
Integrace zámků do aplikace, PMS nebo budoucí platformy probíhá prostřednictvím dvou odlišných sad nástrojů: cloudových API pro vzdálené operace a Bluetooth SDK pro ovládání telefonem v dosahu. Jejich zaměňování je nejčastější chybou v plánování integrací.
Když musí aplikace třetí strany ovládat smart zámky — rezervační kanál vydávající kódy, kancelářská platforma zajišťující přístup návštěvníkům nebo hotelová aplikace doručující mobilní klíče — dodavatel zámků zpřístupní programovatelné rozhraní ve dvou vrstvách. Cloudové API je obvykle služba ve stylu REST dostupná přes HTTPS: aplikace se autentizuje pomocí přihlašovacích údajů ve stylu OAuth, vytváří přístupové kódy nebo elektronické klíče, odesílá příkazy pro vzdálené odemčení online zámků, dotazuje se na stav zámků a přijímá webhooková zpětná volání pro události odemčení, nízké baterie a neoprávněného zásahu. Mobilní SDK je knihovna zabudovaná do vlastní aplikace integrátora pro iOS nebo Android, která zajišťuje vyhledávání přes Bluetooth, zabezpečené připojení, odemykání v dosahu a offline logiku přihlašovacích údajů, aniž by bylo nutné komunikovat se serverem. Úspěšné integrace záměrně využívají obě vrstvy, zabezpečují své přihlašovací údaje a před spuštěním testují limity rychlosti i doručování událostí. Tento průvodce mapuje klíčové pojmy a otázky pro dodavatele. Dostupnost API a SDK, jejich rozsahy a licencování pro každou platformu potvrzujeme písemně v rámci jednotlivé nabídky.
| Cloudové API | Služby HTTPS spravují zámky, přihlašovací údaje a události ze serveru; vzdálené dveře osáhne pouze tehdy, když jsou zámky online prostřednictvím Wi-Fi nebo brány. |
| Mobilní SDK | Zabudované knihovny iOS/Android zajišťují připojení přes Bluetooth, odemykání v dosahu a offline logiku uvnitř vlastní aplikace integrátora. |
| Ověření | Klientské přihlašovací údaje ve stylu OAuth, tokeny s omezeným rozsahem a podepsané webhooky odlišují profesionální platformy od otevřených reléových skriptů. |
| Přihlašovací údaje podle API | Běžné operace vytvářejí časově omezené přístupové kódy, elektronické klíče, karty a odkazy pro návštěvníky a nabízejí koncové body pro vý listing, aktualizaci a odvolání. |
| Doručování událostí | Webhooky oznamují odemčení, použití kódu, nízkou baterii a události u dveří; chování při opakování a záruky pořadí musí být zdokumentovány. |
| Závislost na hardwaru | Vzdálené příkazy se vykonávají pouze na online zámcích přes Wi-Fi nebo bránu, takže návrh API a hardwarová topologie musí být plánovány společně. |
| Naše politika | Poskytujeme dokumentaci rozhraní, sandbox nebo testovací zařízení a technický kontakt; produkční přihlašovací údaje a limity pocházejí z platformové dohody. |
| Cíl integrace | Primární sada nástrojů | Klíčová závislost |
|---|---|---|
| Vydávání časově omezených rezervačních kódů | Cloudové API z backendu rezervačního systému | Zámky podporují požadovaný typ kódu a způsob synchronizace. |
| Značková aplikace pro nájemce | Mobilní SDK plus cloudové API | Tým aplikace řídí vydávání SDK a schvalování v obchodech. |
| Doručování mobilního klíče v hotelu | Události cloudového API z middleware PMS | Služba přihlašovacích údajů a pokrytí dveří bránami. |
| Kiosk pro správu návštěvníků | Cloudové API pro jednorázové přihlašovací údaje | Časová pásma a význam expirace je nutné ověřit včas. |
| Živá vzdálená recepce | Odemčení přes cloudové API plus potvrzení webhookem | Pouze online zámky okamžitě vykonají vzdálené příkazy. |
| Offline podniková peněženka | Mobilní SDK se zabezpečenými místními přihlašovacími údaji | Ukládání klíčů a pravidla odvolání v zařízení. |
API se stýká s fyzickou realitou při otevírání: brány, kovové dveře a výdrž baterie určují, zda se čisté volání API dostane k zámku včas. Pilotní testujte hardware a software společně.
| Otevření | Typické dveře | Přístup k zámku |
|---|---|---|
| Dveře pronajímaného prostoru | Bluetooth zámek s bránou pro danou zónu | Backend rezervačního systému vytváří offline a online kódy prostřednictvím cloudového API. |
| Skleněný vstup do kanceláře | Online čtečka nebo kontrolér | Platforma návštěvníků odesílá jednorázové přihlašovací údaje a přijímá webhooky o vstupu. |
| Hotelový pokoj pro hosty | RFID zámek se službou mobilního klíče | Middleware PMS volá API klíčů; brána odesílá aktuální aktualizace. |
| Dveře coworkingového prostoru | Smart zámek za skleněným fasádou | Aplikace pro členy zabudovává SDK pro odemykání v dosahu, a to i při slabém Wi-Fi. |
| Logistická vrata | Venkovní online zámek | Vzdálené příkazy vyžadují potvrzené připojení a náhradní způsob kontaktu. |
| Místnost s vybavením | Bateriový zámek spravovaný vzdáleně | Webhooky podporují audity využití a kontrolu zneužívání v aplikaci provozovatele. |
API se na prezentacích jeví podobně, ale v provozu se liší. Než integrátoři investují čas do vývoje, měli by shromáždit níže uvedené položky, jejichž koordinaci s platformovým týmem pomáháme.
| Komponenta | Typická logika | Poznámky |
|---|---|---|
| Referenční příručka API | Koncové body, rozsahy, verze a dostupnost sandboxu. | Odhady pro engineering závisejí na úplné a aktuální dokumentaci. |
| Balíček SDK | Podporované verze OS, ukázkové aplikace a četnost vydání. | Je nutné pochopit schvalování v obchodech a model údržby. |
| Bezpečnostní model | Typy tokenů, rotace tajných údajů, podepisování webhooků a možnosti IP. | Ochrana koncových bodů pro odemykání je v produkci nezbytná. |
| Limity a kvóty | Limity rychlosti, stránkování, dávkové operace a pravidla opakování. | Jinak mohou uvedení celé flotily selhat během špičkových hodin přebírání rezervací. |
| Katalog událostí | Typy událostí, datové náplně, pořadí a záruky opětovného doručení. | Funkce auditu a oznámení závisí na spolehlivých událostech. |
API je rozhraní typu server-to-server: vaše backendová aplikace volá platformu zámků přes HTTPS, vytváří kódy, odesílá odemykací příkazy online zámkům, dotazuje se na stav a přijímá webhookové události; funguje bez ohledu na blízkost telefonu. Mobilní SDK je softwarová knihovna zabudovaná do vaší vlastní aplikace pro iOS nebo Android, která komunikuje přímo se zámky přes Bluetooth a umožňuje odemykání v blízkosti, nastavení a offline ukládání přihlašovacích údajů, když není dostupný server. Backendové systémy pro pronájem a integrace PMS primárně potřebují cloudové API; značkové aplikace pro nájemníky obvykle vyžadují SDK plus vybrané volání API. Pokusit se provést vše prostřednictvím API — například odemknout pouze Bluetooth zámek z opačného konce světa bez brány — jednoduše nebude fungovat, takže hardwarovou topologii a výběr rozhraní je nutné navrhovat společně. Dostupná rozhraní každé platformy jsou písemně potvrzena v rámci každé nabídky.
Ano, jde o standardní vzor integrace: po potvrzení rezervace vaše backendová aplikace nebo middleware zavolá API platformy zámků s údaji o pokoji či jednotce, příjezdu a odjezdu a obdrží přístupový kód nebo ekey, který se hostovi doručí prostřednictvím vaší vlastní šablony zprávy nebo e-mailu. Webhooky následně potvrzují použití a označují události, jako jsou pokusy o časný příchod nebo nízká baterie. Je nutné upřesnit zpracování časových pásem pro období pobytu, který typ kódu funguje offline u vybraných zámků, pokrytí branami pro živé odvolání, idempotentní opakování při opětovném odeslání zpráv a způsob aktualizace přihlašovacích údajů při zrušení či změně termínu. Poskytujeme testovací zámky a podporujeme integrační workshopy; podrobnosti o koncových bodech, limity rychlosti a licenční podmínky každé platformy jsou písemně potvrzeny v rámci každé nabídky.
Odemykání na dálku je bezpečné, pokud je platforma postavena jako jakákoli autentizovaná finanční API: tokeny ve stylu OAuth s omezenými oprávněními, serverové úložiště tajných klíčů, oprávnění pro jednotlivé zaměstnance, potvrzování příkazů prostřednictvím webhooků, auditní záznamy a volitelné dvoufázové schvalování pro citlivé dveře. Nebezpečné je to v případě, že integrátoři ukládají dlouhodobé tajné klíče do mobilních aplikací, vystavují otevřené koncové body relé nebo zaznamenávají URL pro odemykání. Důležité jsou také fyzická bezpečnostní opatření: vzdálené příkazy se doručují pouze online zámkům a dveře s vysokým zabezpečením často zcela vypínají odemykání na dálku nebo vyžadují dvojí schválení. Při due diligence žádejte bezpečnostní whitepaper, postup rotace tokenů a schéma podepisování webhooků, místo abyste přijali tvrzení „je k dispozici REST API“. Tyto posudky koordinujeme s týmem platformy a můžeme navrhnout architektury, v nichž je odemykání na dálku omezeno pouze na recepční role.
Webhooky jsou standardním kanálem událostí — záznamy odemykání, zadání kódů, nízká baterie, poplach manipulace a změny snímačů dveří — ale význam doručení se mezi platformami liší. Profesionální platformy podepisují datové části, opakují neúspěšné doručení s prodlevou a poskytují API pro sladění nebo dotazování na zmeškané události, což je důležité, protože sítě mohou krátce selhat a duplicitní doručení je běžné; spotřebitelé proto musí s ID událostí zacházet idempotentně. Zaručení pořadí je slabší: dvě události vytvořené během několika sekund se mohou občas doručit v obráceném pořadí, takže auditní logika by měla používat čas události ze zámku, nikoli čas doručení. Během pilotního projektu simulujte offline přijímač a ověřte chování při opětovném přehrání. Katalog událostí, zásady opakovaného odesílání a koncové body pro sladění u objednané platformy jsou písemně zdokumentovány před zahájením vývoje.
Přístup k API uděluje platforma zámků podle vlastních developerských a obchodních podmínek, zpravidla vlastníkovi účtu: značce nebo provozovateli, který vlastní cloudový projekt, nikoli automaticky každému kupujícímu zámek. Výrobce může pomoci službu aktivovat, dodat dokumentaci a koordinovat technické zavedení, ale nemůže přidělovat práva nad rámec smlouvy s platformou. Některé platformy rozlišují uživatele pouze s aplikací, obchodní účty s řídicími panely a certifikované partnerské vývojáře s plným přístupem k API; některé pokročilé koncové body navíc vyžadují schválení integrace. Kupující, kteří plánují rozsáhlé integrace, by proto měli před výběrem hardwaru potvrdit způsobilost vývojáře, poplatky, podmínky zpracování dat a podporované regiony, protože skvělý zámek bez oprávnění k API nemůže naplnit plánovaný produkt. Aktuální developerské programy a licenční podmínky každé platformy jsou potvrzeny v rámci každého RFQ.
Sdělte nám prostřednictvím RFQ své případy integrace, technologii týmu a plánovaný termín spuštění. Koordinujeme dokumentaci API, balíčky SDK, testovací zařízení a dohody s platformami a podporujeme společný pilotní projekt zahrnující offline režim, opakované odesílání a události ve fleet-scale rozsahu.
Vyžádat specifikační list a nabídkuPřehled technologiíNaposledy aktualizováno: 31. října 2026 · Zkontrolováno redakčním týmem Smart Lock Factory