Bühnen-Timer

Doku

HTTP-API für Räume

Start, Pause, nächster Cue und Flash für einen Raum. Companion und Stream Deck schicken normale HTTP-Requests. Ohne Raum-Secret oder signiertes Token nimmt die API keine Schreibbefehle an. Der Timer unter /timer bleibt in diesem Tab und braucht das nicht.

Auth

  • Raum-Secret (`btctrl_…`) aus der Steuerung, solange du als Inhaber angemeldet bist oder die PIN offen ist.
  • Signiertes Token: `POST /api/v1/rooms/:id/token` mit dem Secret. Standard 30 Tage, höchstens 90.
  • Header `Authorization: Bearer …` oder `X-Room-Secret`. Stream Deck darf `?token=` nutzen — der Wert landet dann in Logs.
  • Cookie oder die Raum-URL allein reichen für /api/v1 nicht.

Endpunkte

Basis: `/api/v1/rooms/:id`. GET oder POST. Flash braucht `text` (JSON oder Query). 60 Schreib-Requests pro Raum und IP und Minute. Fehlversuche extra begrenzt. Antwort `429` mit `Retry-After`.

  • `/start` · `/pause` · `/next` · `/flash`
  • `GET /` · aktueller Stand
  • `POST /token` · neues Token

Companion / Stream Deck

Companion: Generic HTTP, ein Button pro Verb, Header Authorization. Stream Deck: HTTP-Request, GET mit `?token=`. Die fertigen URLs stehen in der Steuerung, wenn du den Raum angelegt hast.