MobiSkan
Pobierz APK
Integracja aplikacji: tokeny API, parowanie urządzeń i webhooki
Parowanie urządzenia z kolektorem
Ścieżka Ustawienia → Terminal danych → Integracja aplikacji to jednocześnie ekran zarządzania tokenami API i miejsce generowania kodów parowania dla aplikacji mobilnej. Każde sparowane urządzenie tworzy jeden token na tej liście – nie ma tutaj osobnego, oddzielnego rejestru urządzeń.
Klikasz „Generuj”, nadajesz nazwę i wybierasz poziom dostępu: „Tylko odczyt” lub „Zapis i odczyt”. Po utworzeniu tokenu pojawia się jednorazowe okno z kodem QR do zeskanowania w aplikacji.
To jedyny moment, w którym surowy token jest w ogóle dostępny. Zamknięcie tego okna oznacza, że nie da się już go ponownie wyświetlić ani wygenerować tego samego kodu QR jeszcze raz. Jeśli operator nie zdążył zeskanować kodu, musisz wygenerować nowy token.
Tabela tokenów
Tabela zawiera kolumny: nazwa, zamaskowany klucz z ostatnimi czterema znakami, poziom dostępu, data utworzenia, ostatnie użycie oraz wersja ustawień. Ta ostatnia pokazuje zielony status „aktualne”, gdy urządzenie ma najnowszą konfigurację, lub szary status „oczekuje”, gdy jeszcze nie pobrało zmian.
Ikona kosza unieważnia token. Okno potwierdzenia jest jednak celowo odwrócone względem typowego układu: przycisk „Unieważnij” jest zwyczajny i znajduje się po lewej stronie, natomiast „Anuluj” jest czerwony i umieszczony po prawej. To świadoma decyzja projektowa, aby osoby przyzwyczajone do automatycznego omijania czerwonych elementów przypadkiem nie unieważniły tokenu.
Status urządzeń
Bieżący stan sparowanych urządzeń (status online, czas ostatniego wykrycia oraz poziom baterii) sprawdzisz nie tutaj, lecz na pulpicie, w kafelku statusu urządzeń.
Webhooki
W menu Ustawienia → Narzędzia → Automatyzacje konfigurujesz webhooki: nazwę, adres URL, listę zdarzeń, na które ma reagować system (utworzenie lub aktualizacja towaru, zamknięcie dokumentu, zmiana stanu, transakcja inwentaryzacyjna) oraz przełącznik aktywności, który zapisuje się od razu po kliknięciu.
Formularz webhooka wymaga zaznaczenia co najmniej jednego zdarzenia – bez tego zapis jest zablokowany. W obecnej wersji systemu nie ma przycisku do wysłania zdarzenia testowego ani podglądu historii dostarczonych powiadomień. Po skonfigurowaniu webhooka zweryfikuj więc jego działanie bezpośrednio po stronie odbierającego systemu.
Na co zwrócić uwagę
Ekran integracji aplikacji pełni podwójną rolę: to zarówno panel API dla programistów, jak i miejsce, w którym administrator paruje nowe urządzenia mobilne z firmą.
