Fejlesztők · REST API és webhookok

A képernyőket az Ön rendszere is vezérelheti. Nélkülünk is.

REST API API-kulccsal, HMAC SHA-256 aláírású webhookok és IoT-adatvégpontok. Minden, ami lent van, ma éles üzemben fut – nincs várólista, nincs béta-űrlap.

API-kulcs létrehozása Kérdés a fejlesztőnek

Alapcím

api.digtria.com

Egy végpont, EU-s hosting

Hitelesítés

API-kulcs

Bearer token vagy X-Api-Key fejléc, csak az Ön szervezetére érvényes

Webhookok

8 esemény

Aláírva, sorban állítva, újrapróbálkozással

Formátum

JSON

Ugyanaz a szerződés minden lejátszóplatformra

REST API

Öt végpont, amely lefedi a flotta üzemeltetését.

Olvassa ki a flottát, küldjön parancsot, írjon szenzormérést vagy anonim nézőszámot. Az API-kulcsot az adminisztrációban hozza létre, és bármikor visszavonhatja.

GET/screens

Képernyők listája állapottal, alkalmazásverzióval, szabad tárhellyel és felbontással.

GET/screens/{id}

Egy képernyő részletei, beleértve az utolsó jelentkezést.

POST/screens/{id}/commands

Távoli parancs: RESTART, REBOOT, FORCE_SYNC, SCREENSHOT, UPDATE_APP, WAKE, SLEEP, CLEAR_CACHE.

POST/sensors

IoT-mérés (hőmérséklet, CO₂, foglaltság…) átjáróból, PLC-ből vagy Home Assistantból.

POST/audience

Anonim közönségösszesítés AI-kamerából: emberek, megjelenések, eltöltött idő. Képek és azonosítás nélkül.

Minden hívás alapcíme: https://api.digtria.com/api/v1/public/v1

digtria-api.shÉles üzem

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

Webhookok: az Ön rendszere értesül elsőként.

Regisztráljon egy címet az adminisztrációban, válassza ki az eseményeket, mi pedig sorból, újrapróbálkozással kézbesítjük. Minden hívás aláírást hordoz, így ellenőrizheti, hogy valóban tőlünk jött.

Események

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

A kézbesítés feladatsoron keresztül fut – a sikertelen hívás növekvő szünettel ismétlődik, a teljes előzmény a kérés és válasz törzsével együtt az adminisztrációban látható.

Aláírás

A törzset HMAC SHA-256 algoritmussal írjuk alá a webhook létrehozásakor megjelenő titokkal. Állandó idejű összehasonlítást használjon – a minta balra látható.

X-Digtria-Signature: sha256=<hmac>

Az adminisztráció hibakeresője bármelyik hívást újrajátssza, így a végpontját valódi hiba nélkül tesztelheti.

Csak az Ön szervezetére érvényesA kulcs kizárólag az őt létrehozó szervezet képernyőit látja. A visszavonás azonnal érvénybe lép.

A kulcsok az Ön kezébenLétrehozás, elnevezés és visszavonás a Beállítások → API-kulcsok alatt. A kulcs egyszer jelenik meg; mi csak a lenyomatát tároljuk.

EU-s hostingAz API, az adatbázis és a médiatár EU-s infrastruktúrán fut. Az adatfeldolgozási szerződés a szerződés része.

Stabil szerződésA mezők bővülnek, nem tűnnek el csendben. A törő változás új útvonalként érkezik, nem hétfő reggeli meglepetésként.

Gyakori kérdések

Van hivatalos SDK?

Még nincs. Az API tiszta REST JSON-nal, így bármelyik HTTP-kliens megteszi – a fenti minták teljesek. Ha egy kész SDK döntene el egy projektet, írja meg, milyen nyelven, és előrevesszük.

Milyen hívási korlátok vannak?

A szokásos üzem nincs korlátozva. A visszaélésszerű forgalmat kulcsonként fékezzük; ha tömeges importot vagy több ezer képernyő lekérdezését tervezi, jelezze, és megbeszéljük a módot – a lekérdezést általában teljesen kiváltja egy webhook.

Futtatható a Digtria a saját szerverünkön?

Igen, enterprise projektekhez on-premise vagy dedikált példány is lehetséges – ugyanaz az API, az Ön infrastruktúrája. Kérje a telepítési dokumentumot.

A biztonság, az SSO és az adatok elhelyezése a következő oldalon olvasható: Enterprise.

Építse ki képernyőhálózatát egy partnerrel.

Hardver, szoftver, tartalom és üzemeltetés — egy csapat tervezi, szállítja és támogatja.

Hardverajánlat kérése