Dezvoltatori · API REST și webhookuri

Ecranele pot fi conduse de sistemul dumneavoastră. Și fără noi.

API REST cu cheie API, webhookuri semnate HMAC SHA-256 și endpointuri pentru date IoT. Tot ce vedeți mai jos rulează azi în producție – fără listă de așteptare, fără formular de beta.

Creează o cheie API Întreabă un dezvoltator

Adresă de bază

api.digtria.com

Un singur endpoint, găzduit în UE

Autentificare

Cheie API

Token Bearer sau antet X-Api-Key, valabil doar pentru organizația dumneavoastră

Webhookuri

8 evenimente

Semnate, puse în coadă și reîncercate

Format

JSON

Același contract pentru orice platformă de player

API REST

Cinci endpointuri care acoperă operarea flotei.

Citiți flota, trimiteți o comandă, scrieți o măsurătoare de senzor sau un număr anonim de privitori. Cheia API se creează în administrare și poate fi revocată oricând.

GET/screens

Lista ecranelor cu stare, versiunea aplicației, spațiu liber și rezoluție.

GET/screens/{id}

Detaliile unui ecran, inclusiv ultimul semnal.

POST/screens/{id}/commands

Comandă la distanță: RESTART, REBOOT, FORCE_SYNC, SCREENSHOT, UPDATE_APP, WAKE, SLEEP, CLEAR_CACHE.

POST/sensors

Măsurătoare IoT (temperatură, CO₂, ocupare…) de la un gateway, PLC sau Home Assistant.

POST/audience

Agregat anonim de public de la o cameră AI: persoane, afișări, timp petrecut. Fără imagini, fără identificare.

Adresa de bază a fiecărui apel: https://api.digtria.com/api/v1/public/v1

digtria-api.shProducție

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

Webhookuri: sistemul dumneavoastră află primul.

Înregistrați o adresă în administrare, alegeți evenimentele, iar noi le livrăm printr-o coadă cu reîncercări. Fiecare apel poartă o semnătură, ca să verificați că vine într-adevăr de la noi.

Evenimente

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

Livrarea trece printr-o coadă de sarcini – un apel eșuat se reia cu pauză crescătoare, iar întregul istoric, inclusiv corpul cererii și al răspunsului, este în administrare.

Semnătură

Corpul este semnat cu HMAC SHA-256 folosind secretul afișat la crearea webhookului. Comparați în timp constant – exemplul este în stânga.

X-Digtria-Signature: sha256=<hmac>

Depanatorul din administrare reia orice apel, astfel încât să testați endpointul fără a aștepta un incident real.

Valabil doar pentru organizația dumneavoastrăO cheie vede exclusiv ecranele organizației care a creat-o. Revocarea are efect imediat.

Cheile sunt sub controlul dumneavoastrăCreați, denumiți și revocați în Setări → Chei API. Cheia se afișează o singură dată; noi păstrăm doar amprenta ei.

Găzduire în UEAPI-ul, baza de date și stocarea media rulează pe infrastructură din UE. Acordul de prelucrare a datelor face parte din contract.

Contract stabilCâmpurile se adaugă, nu dispar în tăcere. O schimbare incompatibilă ar veni ca o cale nouă, nu ca o surpriză luni dimineața.

Întrebări frecvente

Există un SDK oficial?

Încă nu. API-ul este REST simplu cu JSON, deci orice client HTTP funcționează – exemplele de mai sus sunt complete. Dacă un SDK gata făcut ar decide un proiect, spuneți-ne limbajul și îl prioritizăm.

Care sunt limitele de apeluri?

Utilizarea normală nu este limitată. Traficul abuziv este limitat pe cheie; dacă plănuiți un import masiv sau interogarea a mii de ecrane, scrieți-ne și stabilim modul – de obicei un webhook înlocuiește complet interogarea.

Putem rula Digtria pe serverele noastre?

Da, pentru proiecte enterprise este posibilă o instanță on-premise sau dedicată – același API, infrastructura dumneavoastră. Cereți documentul de implementare.

Securitatea, SSO și localizarea datelor sunt descrise pe pagina Enterprise.

Implementați rețeaua de ecrane cu un singur partener.

Hardware, software, conținut și operare — planificate, livrate și susținute de o singură echipă.

Solicită ofertă hardware