TuxDMX-WebUI/docs/MIXITUP.md

MixItUp integration

Triggerendpoint

Primært endpoint:

POST /api/v1/triggers/{slug}
Authorization: Bearer <mixitup-token>
Content-Type: application/json

Eksempel med raid:

POST /api/v1/triggers/raid
Host: tuxdmx.local:8000
Authorization: Bearer REPLACE_WITH_TOKEN
Content-Type: application/json

{
  "eventType": "raid",
  "username": "streamviewer42",
  "displayName": "StreamViewer42",
  "amount": 120,
  "eventId": "raid-evt-20260712-001",
  "platform": "twitch",
  "metadata": {
    "source": "mixitup",
    "notes": "Raid test i simulator"
  }
}

Forventet svar:

{
  "accepted": true,
  "queue_depth": 1
}

HTTP-status:

202 Accepted

Simple endpoints

• POST /api/v1/scenes/{sceneSlug}/activate
• POST /api/v1/effects/{effectSlug}/trigger
• POST /api/v1/dmx/blackout
• POST /api/v1/bpm/tap

Headers

• Authorization: Bearer <token>
• Content-Type: application/json

Token må aldrig sendes i querystring.

MixItUp Web Request Action

1. Vælg POST.
2. Brug URL http://<tuxdmx-host>:8000/api/v1/triggers/<slug>.
3. Tilføj header Authorization med Bearer <token>.
4. Tilføj header Content-Type med application/json.
5. Indsæt JSON-body.

Eksempel-body med MixItUp special identifiers

{
  "eventType": "raid",
  "username": "$username",
  "displayName": "$displayname",
  "amount": "$raidviewercount",
  "eventId": "$eventid",
  "platform": "twitch",
  "metadata": {
    "eventName": "$eventname"
  }
}

Test i simulator-mode

curl -i -X POST http://127.0.0.1:8000/api/v1/triggers/raid \
  -H "Authorization: Bearer test-token" \
  -H "Content-Type: application/json" \
  -d '{"eventType":"raid","displayName":"AuditTest","amount":42,"eventId":"raid-audit-1","platform":"twitch","metadata":{}}'

Sikkerhed

• Roter token ved mistanke om læk.
• Brug IP-allowlist eller reverse proxy, hvis endpointet eksponeres uden for isoleret LAN.
• Rate limiting og duplicate/idempotency skal håndhæves server-side.