Entwickler · REST-API & Webhooks

Ihre Systeme steuern die Bildschirme. Auch ohne uns.

REST-API mit API-Schlüssel, per HMAC SHA-256 signierte Webhooks und Endpunkte für IoT-Daten. Alles unten läuft heute in Produktion – keine Warteliste, kein Beta-Formular.

API-Schlüssel erstellen Entwickler fragen

Basis-URL

api.digtria.com

Ein Endpunkt, gehostet in der EU

Authentifizierung

API-Schlüssel

Bearer-Token oder Header X-Api-Key, nur für Ihre Organisation gültig

Webhooks

8 Ereignisse

Signiert, in der Warteschlange und mit Wiederholung

Format

JSON

Derselbe Vertrag für jede Player-Plattform

REST-API

Fünf Endpunkte für den gesamten Flottenbetrieb.

Flotte auslesen, Befehl senden, Sensorwert oder anonyme Zuschauerzahl schreiben. Den API-Schlüssel erstellen Sie in der Verwaltung und widerrufen ihn jederzeit.

GET/screens

Liste der Bildschirme mit Status, App-Version, freiem Speicher und Auflösung.

GET/screens/{id}

Detail eines Bildschirms inklusive letztem Heartbeat.

POST/screens/{id}/commands

Fernbefehl: RESTART, REBOOT, FORCE_SYNC, SCREENSHOT, UPDATE_APP, WAKE, SLEEP, CLEAR_CACHE.

POST/sensors

IoT-Messwert (Temperatur, CO₂, Belegung…) von Gateway, SPS oder Home Assistant.

POST/audience

Anonymes Publikums-Aggregat einer KI-Kamera: Personen, Impressionen, Verweildauer. Keine Bilder, keine Identifikation.

Basis-URL jedes Aufrufs: https://api.digtria.com/api/v1/public/v1

digtria-api.shProduktion

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

Webhooks: Ihr System erfährt es zuerst.

In der Verwaltung eine URL registrieren, Ereignisse wählen – wir stellen sie über eine Warteschlange mit Wiederholungen zu. Jeder Aufruf trägt eine Signatur, damit Sie prüfen können, dass er wirklich von uns kommt.

Ereignisse

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

Die Zustellung läuft über eine Job-Queue – ein fehlgeschlagener Aufruf wird mit wachsender Pause wiederholt, und die gesamte Historie inklusive Anfrage- und Antworttext sehen Sie in der Verwaltung.

Signatur

Der Body wird mit HMAC SHA-256 und dem beim Anlegen angezeigten Secret signiert. Vergleichen Sie in konstanter Zeit – das Beispiel steht links.

X-Digtria-Signature: sha256=<hmac>

Der Webhook-Debugger in der Verwaltung spielt jeden Aufruf erneut ab, sodass Sie Ihren Endpunkt ohne echten Störfall testen.

Nur für Ihre OrganisationEin Schlüssel sieht ausschließlich die Bildschirme der Organisation, die ihn erstellt hat. Ein Widerruf wirkt sofort.

Schlüssel in Ihrer HandErstellen, benennen und widerrufen in Einstellungen → API-Schlüssel. Der Schlüssel wird einmal angezeigt; wir speichern nur seinen Hash.

Hosting in der EUAPI, Datenbank und Medienspeicher laufen auf EU-Infrastruktur. Ein Auftragsverarbeitungsvertrag gehört zum Vertrag.

Stabiler VertragFelder kommen hinzu, verschwinden nicht still. Eine brechende Änderung käme als neuer Pfad, nicht als Überraschung am Montagmorgen.

Häufige Fragen

Gibt es ein offizielles SDK?

Noch nicht. Die API ist reines REST mit JSON, jeder HTTP-Client genügt – die Beispiele oben sind vollständig. Wenn ein fertiges SDK über ein Projekt entscheidet, sagen Sie uns die Sprache, wir priorisieren es.

Wie sind die Limits?

Normaler Betrieb ist nicht begrenzt. Missbräuchlicher Verkehr wird je Schlüssel gedrosselt; planen Sie einen Massenimport oder das Abfragen tausender Bildschirme, sprechen Sie uns an – meist ersetzt ein Webhook das Polling vollständig.

Kann Digtria auf unseren Servern laufen?

Ja, für Enterprise-Projekte ist eine On-Premise- oder dedizierte Instanz möglich – dieselbe API, Ihre Infrastruktur. Fordern Sie das Deployment-Dokument an.

Sicherheit, SSO und Datenstandort sind beschrieben auf der Seite Enterprise.

Rollen Sie Ihr Bildschirmnetzwerk mit einem Partner aus.

Hardware, Software, Content und Betrieb — geplant, geliefert und betreut von einem Team.

Hardware-Angebot anfordern