Deweloperzy · REST API i webhooki

Ekranami może sterować Twój system. Także bez nas.

REST API na klucz API, webhooki podpisane HMAC SHA-256 i endpointy dla danych IoT. Wszystko poniżej działa dziś na produkcji – bez listy oczekujących i formularza do bety.

Utwórz klucz API Napisz do dewelopera

Adres bazowy

api.digtria.com

Jeden endpoint, hosting w UE

Uwierzytelnianie

Klucz API

Token Bearer lub nagłówek X-Api-Key, ważny tylko dla Twojej organizacji

Webhooki

8 zdarzeń

Podpisane, w kolejce i z ponawianiem

Format

JSON

Ten sam kontrakt dla każdej platformy odtwarzacza

REST API

Pięć endpointów, które obsłużą pracę floty.

Odczytaj flotę, wyślij polecenie, zapisz pomiar czujnika albo anonimową liczbę widzów. Klucz API tworzysz w administracji i w każdej chwili go odwołasz.

GET/screens

Lista ekranów ze statusem, wersją aplikacji, wolnym miejscem i rozdzielczością.

GET/screens/{id}

Szczegóły jednego ekranu wraz z ostatnim sygnałem.

POST/screens/{id}/commands

Polecenie zdalne: RESTART, REBOOT, FORCE_SYNC, SCREENSHOT, UPDATE_APP, WAKE, SLEEP, CLEAR_CACHE.

POST/sensors

Pomiar IoT (temperatura, CO₂, zajętość…) z bramki, sterownika PLC lub Home Assistanta.

POST/audience

Anonimowy agregat publiczności z kamery AI: osoby, odsłony, czas przy ekranie. Bez zdjęć i identyfikacji.

Adres bazowy każdego wywołania: https://api.digtria.com/api/v1/public/v1

digtria-api.shProdukcja

curl -s https://api.digtria.com/api/v1/public/v1/screens \
  -H "Authorization: Bearer sk_live_…"

# vzdialený príkaz obrazovke
curl -X POST https://api.digtria.com/api/v1/public/v1/screens/{id}/commands \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"type":"FORCE_SYNC"}'

Webhooki: Twój system dowiaduje się pierwszy.

W administracji rejestrujesz adres, wybierasz zdarzenia, a my dostarczamy je przez kolejkę z ponawianiem. Każde wywołanie niesie podpis, więc sprawdzisz, że naprawdę pochodzi od nas.

Zdarzenia

screen.onlinescreen.offlinestorage.criticaltemp.highrollout.haltedcampaign.endedmedia.approvedmedia.rejected

Dostarczanie idzie przez kolejkę zadań – nieudane wywołanie powtarza się z rosnącą przerwą, a pełną historię wraz z treścią żądania i odpowiedzi widzisz w administracji.

Podpis

Treść jest podpisana HMAC SHA-256 sekretem pokazanym przy tworzeniu webhooka. Porównuj w stałym czasie – przykład jest po lewej.

X-Digtria-Signature: sha256=<hmac>

Debuger w administracji odtwarza dowolne wywołanie, więc przetestujesz swój endpoint bez czekania na prawdziwą awarię.

Ważny tylko dla Twojej organizacjiKlucz widzi wyłącznie ekrany organizacji, która go utworzyła. Odwołanie działa natychmiast.

Klucze pod Twoją kontroląTworzysz, nazywasz i odwołujesz w Ustawienia → Klucze API. Klucz pokazujemy raz; przechowujemy tylko jego skrót.

Hosting w UEAPI, baza danych i magazyn mediów działają na infrastrukturze w UE. Umowa powierzenia danych jest częścią umowy.

Stabilny kontraktPola przybywają, nie znikają po cichu. Zmiana łamiąca zgodność przyszłaby jako nowa ścieżka, nie jako niespodzianka w poniedziałek rano.

Częste pytania

Czy jest oficjalne SDK?

Jeszcze nie. API to czysty REST z JSON, więc wystarczy dowolny klient HTTP – powyższe przykłady są kompletne. Jeśli gotowe SDK miałoby przesądzić o projekcie, napisz w jakim języku, a damy mu priorytet.

Jakie są limity wywołań?

Zwykła praca nie jest ograniczana. Nadużycia ograniczamy per klucz; jeśli planujesz masowy import albo odpytywanie tysięcy ekranów, odezwij się i ustalimy sposób – zwykle webhook całkowicie zastępuje odpytywanie.

Czy Digtria może działać na naszych serwerach?

Tak, dla projektów enterprise możliwa jest instancja on-premise lub dedykowana – to samo API, Twoja infrastruktura. Poproś o dokument wdrożeniowy.

Bezpieczeństwo, SSO i lokalizacja danych są opisane na stronie Enterprise.

Wdróż sieć ekranów z jednym partnerem.

Sprzęt, oprogramowanie, treści i operacje — zaplanowane, dostarczone i wspierane przez jeden zespół.

Poproś o ofertę na sprzęt