Vývojári · REST API a webhooky

Obrazovky vie riadiť váš systém. Aj bez nás.

REST API na API kľúč, webhooky podpísané HMAC SHA-256 a endpointy pre IoT údaje. Všetko nižšie je v produkcii dnes – žiadny čakací zoznam, žiadny formulár do bety.

Vytvoriť API kľúč Napísať vývojárovi

Základná adresa

api.digtria.com

Jeden endpoint, hosting v EÚ

Overenie

API kľúč

Bearer token alebo hlavička X-Api-Key, platí len pre vašu organizáciu

Webhooky

8 udalostí

Podpísané, vo fronte a s opakovaním

Formát

JSON

Rovnaký kontrakt pre každú platformu prehrávača

REST API

Päť endpointov, ktoré pokryjú prevádzku flotily.

Prečítajte si flotilu, pošlite príkaz, zapíšte meranie senzora alebo anonymný počet divákov. API kľúč si vytvoríte v administrácii a kedykoľvek ho zrušíte.

GET/screens

Zoznam obrazoviek so stavom, verziou aplikácie, voľným úložiskom a rozlíšením.

GET/screens/{id}

Detail jednej obrazovky vrátane posledného hlásenia.

POST/screens/{id}/commands

Vzdialený príkaz: RESTART, REBOOT, FORCE_SYNC, SCREENSHOT, UPDATE_APP, WAKE, SLEEP, CLEAR_CACHE.

POST/sensors

IoT meranie (teplota, CO₂, obsadenosť…) z brány, PLC alebo Home Assistanta.

POST/audience

Anonymný agregát publika z AI kamery: ľudia, impresie, čas pri obrazovke. Žiadne snímky, žiadna identifikácia.

Základná adresa každého volania: https://api.digtria.com/api/v1/public/v1

digtria-api.shProdukcia

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"}'

Webhooky: váš systém sa dozvie prvý.

V administrácii zaregistrujete adresu, vyberiete udalosti a my ich doručíme cez frontu s opakovaním. Každé volanie nesie podpis, takže si overíte, že prišlo naozaj od nás.

Udalosti

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

Doručenie ide cez frontu úloh – neúspešné volanie sa opakuje s narastajúcou pauzou a celú históriu vrátane tela požiadavky a odpovede vidíte v administrácii.

Podpis

Telo je podpísané HMAC SHA-256 tajomstvom, ktoré uvidíte pri vytvorení webhooku. Porovnávajte ho v konštantnom čase – ukážka je vľavo.

X-Digtria-Signature: sha256=<hmac>

Ladiaci nástroj v administrácii prehrá ľubovoľné volanie znova, takže svoj endpoint otestujete bez čakania na skutočnú poruchu.

Platí len pre vašu organizáciuKľúč vidí výhradne obrazovky organizácie, ktorá ho vytvorila. Zrušenie kľúča platí okamžite.

Kľúče máte pod kontrolouVytvoríte, pomenujete a zrušíte ich v Nastavenia → API kľúče. Kľúč sa ukáže raz; my si uchovávame len jeho odtlačok.

Hosting v EÚAPI, databáza aj úložisko médií bežia na infraštruktúre v EÚ. Spracovateľská zmluva je súčasťou zmluvy.

Stabilný kontraktPolia pribúdajú, nemiznú potichu. Zmena, ktorá by niečo rozbila, príde ako nová cesta, nie ako prekvapenie v pondelok ráno.

Časté otázky

Existuje oficiálne SDK?

Zatiaľ nie. API je čisté REST s JSON, takže stačí ľubovoľný HTTP klient – ukážky vyššie sú kompletné. Ak by o projekte rozhodlo hotové SDK, napíšte, v akom jazyku, a dáme ho na začiatok radu.

Aké sú limity volaní?

Bežná prevádzka obmedzená nie je. Zneužívajúcu premávku brzdíme podľa kľúča; ak plánujete hromadný import alebo dopytovanie tisícok obrazoviek, ozvite sa a dohodneme postup – dopytovanie zvyčajne úplne nahradí webhook.

Dá sa Digtria prevádzkovať na našich serveroch?

Áno, pre enterprise projekty je možná on-premise alebo vyhradená inštancia – rovnaké API, vaša infraštruktúra. Vyžiadajte si dokument k nasadeniu.

Bezpečnosť, SSO a umiestnenie dát sú popísané na stránke Enterprise.

Nasaďte sieť obrazoviek s jedným partnerom.

Hardvér, softvér, obsah a prevádzka — naplánované, dodané a podporované jedným tímom.

Vyžiadať ponuku na hardvér