
Integracja zamków z aplikacją, PMS lub platformą budynkową odbywa się za pomocą dwóch odrębnych zestawów narzędzi: API chmurowych do operacji zdalnych oraz SDK Bluetooth do sterowania telefonem w zasięgu. Pomylenie ich jest najczęstszym błędem w planowaniu integracji.
Gdy aplikacja zewnętrzna musi obsługiwać inteligentne zamki — kanał wynajmu wydający kody, platforma biurowa rejestrująca odwiedzających lub aplikacja hotelowa przekazująca klucze mobilne — dostawca zamków udostępnia programowalne interfejsy w dwóch warstwach. API chmurowe jest zwykle usługą w stylu REST działającą przez HTTPS: aplikacja uwierzytelnia się za pomocą poświadczeń w stylu OAuth, tworzy kody lub eklucze, wysyła zdalne polecenia otwarcia do zamków online, sprawdza stan zamka i odbiera wywołania zwrotne webhook dotyczące otwarcia, niskiego poziomu baterii oraz ingerencji. SDK mobilne to biblioteka osadzona we własnej aplikacji iOS lub Android integratora, która obsługuje wykrywanie Bluetooth, bezpieczne połączenie, otwieranie w zasięgu i offlineową logikę poświadczeń bez łączenia się z serwerem. Skuteczne integracje celowo wykorzystują obie warstwy, zabezpieczają swoje poświadczenia oraz testują limity żądań i dostarczanie zdarzeń przed uruchomieniem. Ten przewodnik przedstawia najważniejsze pojęcia i pytania do dostawcy. Dostępność API i SDK, zakresy oraz licencje dla każdej platformy są potwierdzane pisemnie w ramach każdej oferty.
| API chmurowe | Usługi HTTPS zarządzają zamkami, poświadczeniami i zdarzeniami z serwera; umożliwiają zdalne otwieranie drzwi tylko wtedy, gdy zamki są online i połączone przez Wi-Fi lub bramkę. |
| SDK mobilne | Osadzone biblioteki iOS/Android obsługują połączenie Bluetooth, otwieranie w zasięgu i logikę offline wewnątrz własnej aplikacji integratora. |
| Uwierzytelnianie | Poświadczenia klienta w stylu OAuth, tokeny z określonym zakresem i podpisane webhooki oddzielają profesjonalne platformy od otwartych skryptów przekazujących. |
| Poświadczenia w API | Typowe operacje obejmują tworzenie kodów z datą ważności, ekluczy, kart i linków dla odwiedzających oraz udostępniają punkty końcowe do listowania, aktualizacji i unieważniania. |
| Dostarczanie zdarzeń | Webhooki informują o otwarciu, użyciu kodu, niskim poziomie baterii i zdarzeniach przy drzwiach; zachowanie przy ponawianiu oraz gwarancje kolejności muszą być udokumentowane. |
| Zależność od sprzętu | Zdalne polecenia wykonują wyłącznie zamki online połączone przez Wi-Fi lub bramkę, dlatego projekt API i topologia sprzętowa muszą być planowane łącznie. |
| Nasza polityka | Udostępniamy dokumentację interfejsów, środowisko testowe lub urządzenia testowe oraz kontakt techniczny; poświadczenia produkcyjne i limity pochodzą z umowy dotyczącej platformy. |
Automatyzacja po stronie serwera (kanały wynajmu, PMS, zarządzanie odwiedzającymi) opiera się na API chmurowym; aplikacje mobilne własnej marki z kontrolą w zasięgu lub offline wymagają dodatkowo SDK mobilnego. Produkty korzystające z obu rozwiązań powinny zaprojektować model poświadczeń przed rozpoczęciem pisania kodu.
| Cel integracji | Podstawowy zestaw narzędzi | Kluczowa zależność |
|---|---|---|
| Wydawanie kodów wynajmu z datą ważności | API chmurowe z backendu systemu rezerwacji | Zamki obsługują docelowy typ kodu i ścieżkę synchronizacji. |
| Aplikacja najemcy własnej marki | SDK mobilne oraz API chmurowe | Zespół aplikacji odpowiada za wydanie SDK i przegląd w sklepie. |
| Przekazywanie mobilnych kluczy hotelowych | Zdarzenia API chmurowego z oprogramowania pośredniczącego PMS | Usługa poświadczeń i pokrycie bramkami przy drzwiach. |
| Kiosk do zarządzania odwiedzającymi | API chmurowe do poświadczeń jednorazowych | Strefy czasowe i reguły wygaśnięcia należy zweryfikować wcześnie. |
| Obsługa gościa na żywo zdalnie | Otwarcie przez API chmurowe oraz potwierdzenie webhookiem | Tylko zamki online natychmiast wykonują zdalne polecenia. |
| Offlineowy portfel przedsiębiorstwa | SDK mobilne z zabezpieczonymi poświadczeniami lokalnymi | Przechowywanie kluczy i reguły unieważniania na urządzeniu. |
API styka się z rzeczywistością fizyczną już przy otwieraniu: bramki, metalowe drzwi i zużycie baterii decydują, czy czyste wywołanie API dotrze do zamka na czas. Należy testować sprzęt i oprogramowanie łącznie.
| Otwarcie | Typowe drzwi | Podejście do zamka |
|---|---|---|
| Drzwi lokalu wynajmowanego | Zamek Bluetooth z bramką dla danego obszaru | Backend rezerwacji tworzy kody offline i online za pośrednictwem API chmurowego. |
| Szklane wejście do biura | Czytnik online lub kontroler | Platforma odwiedzających wysyła poświadczenia jednorazowe i odbiera webhooki dotyczące wejść. |
| Pokój gościa w hotelu | Zamek RFID z usługą kluczy mobilnych | Oprogramowanie pośredniczące PMS wywołuje API kluczy; bramka przesyła aktualizacje na żywo. |
| Drzwi przestrzeni współdzielonej | Inteligentny zamek za przeszkloną elewacją | Aplikacja dla członków osadza SDK umożliwiając otwieranie w zasięgu nawet przy słabym Wi-Fi. |
| Brama logistyczna | Zewnętrzny zamek online | Zdalne polecenia wymagają potwierdzonej łączności i kontaktów awaryjnych. |
| Pomieszczenie usługowe | Zamek bateryjny zarządzany zdalnie | Webhooki umożliwiają audyt wykorzystania w aplikacji operatora, rozliczenia i kontrolę nadużyć. |
API wyglądają podobnie na prezentacjach, ale różnią się w środowisku produkcyjnym. Zanim zaangażują czas inżynierów, integratorzy powinni zebrać poniższe elementy, których koordynację z zespołem platformy pomagamy zapewnić.
| Składnik | Typowa logika | Uwagi |
|---|---|---|
| Dokumentacja API | Punkty końcowe, zakresy, wersje i dostępność środowiska testowego. | Szacunki inżynierskie zależą od kompletnej i aktualnej dokumentacji. |
| Pakiet SDK | Obsługiwane wersje systemów operacyjnych, przykładowe aplikacje i częstotliwość wydań. | Należy rozumieć wymagania dotyczące zatwierdzenia w sklepie i model utrzymania. |
| Model bezpieczeństwa | Typy tokenów, rotacja sekretów, podpisywanie webhooków i opcje ograniczania adresów IP. | Ochrona punktów końcowych otwarcia jest bezwzględnie wymagana w środowisku produkcyjnym. |
| Limity i przydziały | Limity żądań, stronicowanie, operacje wsadowe i reguły ponawiania. | W przeciwnym razie uruchomienia floty mogą nie powieść się w godzinach największego ruchu przy check-inie. |
| Katalog zdarzeń | Typy zdarzeń, ładunki, kolejność i gwarancje ponownego dostarczania. | Funkcje audytu i powiadomień zależą od niezawodnego dostarczania zdarzeń. |
API to interfejs między serwerami: Twój backend wywołuje platformę zamków przez HTTPS, aby tworzyć kody, wysyłać polecenia odblokowania do zamków online, sprawdzać ich stan i odbierać zdarzenia webhook. Działa to niezależnie od obecności telefonu w pobliżu. Mobilny SDK to biblioteka oprogramowania wbudowana we własną aplikację na iOS lub Android, która komunikuje się bezpośrednio z zamkami przez Bluetooth, umożliwiając odblokowanie w pobliżu, konfigurację oraz przechowywanie danych uwierzytelniających offline, gdy serwer jest niedostępny. Backendy wypożyczalni i integracje PMS potrzebują głównie API w chmurze; aplikacje najmujących pod marką zwykle wymagają SDK oraz wybranych wywołań API. Próba wykonania wszystkiego przez API — na przykład odblokowania zamka obsługującego wyłącznie Bluetooth z drugiego końca świata bez bramki — po prostu nie zadziała, dlatego topologię sprzętową i wybór interfejsu należy zaprojektować wspólnie. Dostępne interfejsy dla każdej platformy są potwierdzane na piśmie w ramach oferty.
Tak, jest to standardowy wzorzec integracji: po potwierdzeniu rezerwacji backend lub oprogramowanie pośredniczące wywołuje API platformy zamków, przekazując pokój lub jednostkę, daty przyjazdu i wyjazdu, i otrzymuje kod PIN lub ekey, który jest dostarczany gościowi za pośrednictwem własnego szablonu wiadomości lub e-maila. Następnie webhooki potwierdzają użycie i sygnalizują zdarzenia, takie jak próby wcześniejszego zameldowania lub niski poziom baterii. Należy ustalić obsługę stref czasowych dla zakresów dat, rodzaj kodu działający offline w wybranych zamkach, pokrycie bramkami dla natychmiastowego unieważnienia, idempotentne ponowienia wysyłki wiadomości oraz sposób aktualizacji danych uwierzytelniających po anulowaniu lub zmianie terminów. Zapewniamy testowe zamki i wspieramy warsztaty integracyjne; szczegóły punktów końcowych, limity żądań i licencjonowanie dla każdej platformy są potwierdzane na piśmie w ramach oferty.
Zdalne odblokowanie jest bezpieczne, gdy platforma jest zbudowana jak uwierzytelniane API finansowe: tokeny w stylu OAuth z ograniczonym zakresem uprawnień, serwerowe przechowywanie sekretów, uprawnienia dla poszczególnych pracowników, potwierdzanie poleceń przez webhook, dzienniki audytu oraz opcjonalne zatwierdzanie dwuosobowe dla drzwi o szczególnym znaczeniu. Zagrożenie pojawia się, gdy integratorzy osadzają długoterminowe sekrety w aplikacjach mobilnych, udostępniają otwarte punkty końcowe przekaźników lub zapisują adresy URL służące do odblokowania. Istotne są również zabezpieczenia fizyczne: zdalne polecenia docierają wyłącznie do zamków online, a drzwi o wysokim poziomie bezpieczeństwa często całkowicie wyłączają zdalne odblokowanie lub wymagają zatwierdzenia przez dwie osoby. W ramach due diligence należy poprosić o dokumentację bezpieczeństwa, procedurę rotacji tokenów i schemat podpisywania webhooków, zamiast akceptować deklarację „dostępne REST API”. Koordynujemy takie przeglądy z zespołem platformy i możemy zaproponować architektury, w których zdalne odblokowanie jest ograniczone do ról recepcji.
Webhooki są standardowym kanałem zdarzeń — rejestró odblokowań, wpisów kodów, niskiego poziomu baterii, alarmów manipulacji i zmian czujników drzwi — ale semantyka dostarczania różni się w zależności od platformy. Profesjonalne platformy podpisują ładunki, ponawiają nieudane dostarczenia z rosnącym opóźnieniem i udostępniają API do uzgadniania lub odpytywania pominiętych zdarzeń, co jest ważne, ponieważ sieci czasem zawodzą, a podwójne dostarczenie jest normalne; odbiorcy muszą zatem traktować identyfikatory zdarzeń jako idempotentne. Gwarancje kolejności są słabsze: dwa zdarzenia wygenerowane w odstępie kilku sekund czasem mogą dotrzeć w odwrotnej kolejności, dlatego logika audytu powinna korzystać z czasu zdarzenia w zamyku, a nie z czasu jego otrzymania. W fazie pilotażowej należy zasymulować niedostępny odbiornik i sprawdzić zachowanie podczas ponownego wysyłania. Katalog zdarzeń, politykę ponawiania i punkty końcowe uzgadniania dla uporządkowanej platformy są dokumentowane na piśmie przed rozpoczęciem prac programistycznych.
Dostęp do API jest przyznawany przez platformę zamków zgodnie z jej własnymi warunkami deweloperskimi i komercyjnymi, zazwyczaj właścicielowi konta: marce lub operatorowi, który jest właścicielem projektu chmurowego, a nie automatycznie każdemu kupującemu zamek. Fabryka może pomóc w aktywacji usługi, dostarczyć dokumentację i skoordynować wdrożenie techniczne, ale nie może przyznawać praw wykraczających poza umowę z platformą. Niektóre platformy rozróżniają wyłącznie użytkowników aplikacji, konta biznesowe z pulpity oraz certyfikowanych partnerów deweloperskich z pełnym dostępem do API, a niektóre zaawansowane punkty końcowe wymagają zatwierdzenia przeglądu integracji. Kupujący planujący zaawansowane integracje powinni zatem potwierdzić uprawnienia dewelopera, opłaty, warunki przetwarzania danych i obsługiwane regiony przed wyborem sprzętu, ponieważ świetny zamek bez uprawnień do API nie może obsługiwać planowanego produktu. Bieżące programy deweloperskie i licencjonowanie dla każdej platformy są potwierdzane w ramach RFQ.
Przedstaw scenariusze integracji, stos technologiczny zespołu i harmonogram wdrożenia w ramach RFQ. Koordynujemy dokumentację API, pakiety SDK, urządzenia testowe i umowy z platformami oraz wspieramy wspólny pilotaż obejmujący tryb offline, ponowienia i zdarzenia w skali floty.
Poproś o kartę techniczną i wycenęPrzegląd technologiiOstatnia aktualizacja: 31 października 2026 r. · Zweryfikowane przez redakcję Smart Lock Factory