Vývojáři · REST API a webhooky

Obrazovky umí řídit váš systém. I bez nás.

REST API na API klíč, webhooky podepsané HMAC SHA-256 a endpointy pro IoT data. Všechno níže je dnes v produkci – žádný čekací seznam, žádný formulář do bety.

Vytvořit API klíč Napsat vývojáři

Základní adresa

api.digtria.com

Jeden endpoint, hosting v EU

Ověření

API klíč

Bearer token nebo hlavička X-Api-Key, platí jen pro vaši organizaci

Webhooky

8 událostí

Podepsané, ve frontě a s opakováním

Formát

JSON

Stejný kontrakt pro každou platformu přehrávače

REST API

Pět endpointů, které pokryjí provoz flotily.

Přečtěte si flotilu, pošlete příkaz, zapište měření senzoru nebo anonymní počet diváků. API klíč si vytvoříte v administraci a kdykoli ho zrušíte.

GET/screens

Seznam obrazovek se stavem, verzí aplikace, volným úložištěm a rozlišením.

GET/screens/{id}

Detail jedné obrazovky včetně posledního hlášení.

POST/screens/{id}/commands

Vzdálený příkaz: RESTART, REBOOT, FORCE_SYNC, SCREENSHOT, UPDATE_APP, WAKE, SLEEP, CLEAR_CACHE.

POST/sensors

IoT měření (teplota, CO₂, obsazenost…) z brány, PLC nebo Home Assistanta.

POST/audience

Anonymní agregát publika z AI kamery: lidé, imprese, čas u obrazovky. Žádné snímky, žádná identifikace.

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

digtria-api.shProdukce

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 se dozví první.

V administraci zaregistrujete adresu, vyberete události a my je doručíme přes frontu s opakováním. Každé volání nese podpis, takže si ověříte, že přišlo opravdu od nás.

Události

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

Doručení jde přes frontu úloh – neúspěšné volání se opakuje s rostoucí pauzou a celou historii včetně těla požadavku a odpovědi vidíte v administraci.

Podpis

Tělo je podepsáno HMAC SHA-256 tajemstvím, které uvidíte při vytvoření webhooku. Porovnávejte ho v konstantním čase – ukázka je vlevo.

X-Digtria-Signature: sha256=<hmac>

Ladicí nástroj v administraci přehraje libovolné volání znovu, takže svůj endpoint otestujete bez čekání na skutečnou poruchu.

Platí jen pro vaši organizaciKlíč vidí výhradně obrazovky organizace, která ho vytvořila. Zrušení klíče platí okamžitě.

Klíče máte pod kontrolouVytvoříte, pojmenujete a zrušíte je v Nastavení → API klíče. Klíč se ukáže jednou; my uchováváme jen jeho otisk.

Hosting v EUAPI, databáze i úložiště médií běží na infrastruktuře v EU. Zpracovatelská smlouva je součástí smlouvy.

Stabilní kontraktPole přibývají, nemizí potichu. Změna, která by něco rozbila, přijde jako nová cesta, ne jako překvapení v pondělí ráno.

Časté dotazy

Existuje oficiální SDK?

Zatím ne. API je čisté REST s JSON, takže stačí libovolný HTTP klient – ukázky výše jsou kompletní. Pokud by o projektu rozhodlo hotové SDK, napište v jakém jazyce a dáme ho na začátek řady.

Jaké jsou limity volání?

Běžný provoz omezený není. Zneužívající provoz brzdíme podle klíče; pokud plánujete hromadný import nebo dotazování tisíců obrazovek, ozvěte se a domluvíme postup – dotazování obvykle zcela nahradí webhook.

Lze Digtrii provozovat na našich serverech?

Ano, pro enterprise projekty je možná on-premise nebo vyhrazená instance – stejné API, vaše infrastruktura. Vyžádejte si dokument k nasazení.

Bezpečnost, SSO a umístění dat jsou popsány na stránce Enterprise.

Nasaďte síť obrazovek s jedním partnerem.

Hardware, software, obsah a provoz — naplánované, dodané a podporované jedním týmem.

Vyžádat nabídku na hardware