Logitech Sync API: zdalne uruchamianie aktualizacji urządzeń
Od 1 października 2026 Sync Cloud API Logitecha pozwala uruchomić aktualizację oprogramowania nawet 1000 urządzeń jednym wywołaniem z własnych narzędzi.
Logitech w notach wydania Sync Portal z 1 października 2026 dodał do Sync Cloud API endpointy pozwalające uruchamiać aktualizacje oprogramowania urządzeń Logitech. Sama nota ma jedno zdanie, ale szczegóły są w publicznej dokumentacji API: aktualizację zleca się listą identyfikatorów urządzeń, a API zwraca wynik osobno dla każdego z nich. To uzupełnia zmiany z 18 września, kiedy API dostało tworzenie i edycję pokoi, grup oraz odczyt kanałów aktualizacji.
Jak działa nowe wywołanie
Aktualizację uruchamia się zapytaniem POST /org/{orgId}/device/update z listą deviceIds. Dokumentacja podaje następujące zasady:
- jedno zapytanie obejmuje od 1 do 1000 urządzeń, bez powtórzeń identyfikatorów,
- aktualizacja startuje tylko na urządzeniach, które w odpowiedzi GET /org/{orgId}/place mają updateStatus równy UpdateAvailable,
- odpowiedź SUCCESS oznacza, że polecenie dotarło do urządzenia, a nie że aktualizacja się zakończyła,
- urządzenia już aktualne albo właśnie się aktualizujące także zwracają SUCCESS i pozostają bez zmian,
- każde urządzenie jest obsługiwane niezależnie, więc błąd jednego nie zatrzymuje pozostałych.
Postęp sprawdza się w polu updateStatus urządzenia, które przyjmuje wartości UpToDate, UpdateAvailable i UpdateInProgress. Gdy aktualizacja jest dostępna lub trwa, API pokazuje również pole availableVersion z wersją docelową obok bieżącej wersji CollabOS lub firmware.
Kody błędów i warunki licencyjne
| Kod | Znaczenie według dokumentacji |
|---|---|
| DEVICE_NOT_FOUND | urządzenie nie istnieje |
| NOT_ENTITLED | urządzenie nie ma uprawnienia do aktualizacji z API; trzeba przypisać kontrakt do pokoju lub biurka |
| INVALID_DEVICE_TYPE | ten typ urządzenia nie obsługuje aktualizacji przez Sync Cloud API |
| DEVICE_IN_USE | urządzenie jest w użyciu, na przykład w spotkaniu; ponowić później |
| DEVICE_OFFLINE | urządzenie offline lub bez połączenia z Sync; ponowić po powrocie online |
Korzystanie z Sync Cloud API wymaga co najmniej jednego licencjonowanego pokoju lub biurka albo aktywnego okresu próbnego. Dokumentacja wymienia kontrakty Select, Essential i Sync Plus. Uwierzytelnianie odbywa się certyfikatem mTLS. Limity to 14 400 zapytań na dobę, 1 zapytanie na sekundę w trybie ciągłym i do 10 na sekundę chwilowo.
Kanały aktualizacji
Każdy pokój ma przypisany kanał aktualizacji. Lista kanałów, pobierana przez GET /org/{orgId}/update-channel, zawiera kanały zarządzane przez Logitech (w dokumentacji oznaczenia $prod, $beta i $mtrProd) oraz kanały własne organizacji. Dla każdego kanału API podaje wersję docelową per typ urządzenia i flagę outdated, gdy dostępna jest nowsza wersja niż ta, na którą wskazuje kanał. Wywołanie aktualizacji przenosi więc urządzenie na wersję wynikającą z jego kanału, a nie na dowolną.
Co to znaczy dla integratora
Jeśli obsługujecie klientów na Logitech Sync z kontraktem Select, Essential lub Sync Plus, aktualizacje można teraz wpiąć we własny harmonogram serwisowy lub system zgłoszeń. W praktyce oznacza to skrypt uruchamiany poza godzinami pracy, który pobiera listę urządzeń ze statusem UpdateAvailable, zleca aktualizację i po czasie sprawdza wynik.
Warto od razu zaplanować obsługę kodów DEVICE_IN_USE i DEVICE_OFFLINE. API nie kolejkuje takich urządzeń za administratora, więc procedura musi zakładać ponowienie i raport z urządzeń, które się nie zaktualizowały.
Przed automatyzacją dobrze jest uporządkować kanały aktualizacji w organizacjach klientów. Skoro API aktualizuje do wersji wynikającej z kanału, sale testowe powinny być na kanale wcześniejszym, a sale reprezentacyjne na produkcyjnym albo własnym, zatwierdzonym przez klienta.
Dla klientów, którzy dziś aktualizują urządzenia ręcznie z portalu, to dobry powód do rozmowy o kontrakcie serwisowym obejmującym zarządzanie aktualizacjami po stronie integratora.
Co sprawdzić u siebie
- Które organizacje klientów w Logitech Sync mają przypisane kontrakty Select, Essential lub Sync Plus.
- Czy dla tych organizacji wygenerowano certyfikat mTLS do Sync Cloud API.
- Jakie kanały aktualizacji są przypisane do poszczególnych pokoi i czy któryś ma flagę outdated.
- Ile urządzeń ma dziś status UpdateAvailable.
- Czy procedura aktualizacji przewiduje ponowienie dla urządzeń zajętych lub offline.