Alarm per HTTPS auslösen

Externe Systeme — Smart Home, Monitoring, Skripte — können Alarme für deinen Account auslösen.

1. API-Key erzeugen

In der App unter Settings → API → API-Key erzeugen. Der Key wird nur einmal angezeigt und lässt sich jederzeit widerrufen.

Beim Anlegen wählst du die Berechtigung: Nur auslösen für Sensoren und Webhooks, oder Auslösen und lesen, wenn das aufrufende System auch den Zustellstatus abfragen soll. Die Stufe lässt sich später nicht ändern — dafür einen neuen Key erzeugen.

2. Request senden

Am einfachsten als Link (GET) — funktioniert im Browser, in Smart-Home-Zentralen und Webhooks:

https://alarm.indigoblue.at/alarm?key=<DEIN-API-KEY>&title=Alarm&message=Details

Leerzeichen und Sonderzeichen URL-kodieren (%20 für Leerzeichen). Alternativ als POST mit JSON:

curl -X POST https://alarm.indigoblue.at/alarm \
  -H "X-Api-Key: <DEIN-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{"title":"Alarm","message":"Details"}'

• title (Pflicht, max. 200 Zeichen), message (optional, max. 2000 Zeichen).
• Alle aktiven Geräte des Accounts werden alarmiert.
• Antwort: {"ok":true,"alarmId":"…","sent":3,"failed":[]} — sent ist die Zahl erreichter Geräte.
• Rate-Limit: höchstens 10 Alarme pro Minute und Account.

3. Zustellung verfolgen (Keys mit Leserechten)

Ein Alarm ist erst erledigt, wenn ein Mensch quittiert hat. Diese Abfragen zeigen, ob das passiert ist — alle mit dem Header X-Api-Key:

• GET /alarm/status — die letzten 20 Alarme mit Zählern für zugestellt und bestätigt.
• GET /alarm/status/<alarmId> — je Gerät: sent_at, delivered_at, confirmed_at, fcm_error.
• GET /alarm/devices — gekoppelte Geräte; disabled: 1 heißt: bekommt keine Alarme.
• GET /alarm/account — Tarif, Gerätelimit (0 = unbegrenzt) und Verschlüsselung.

curl https://alarm.indigoblue.at/alarm/status \
  -H "X-Api-Key: <DEIN-API-KEY>"

KI-Assistenten

Die Schnittstelle ist als OpenAPI-Beschreibung abrufbar, sodass ein Assistent sie ohne weitere Einrichtung benutzen kann: alarmieren und anschließend melden, wer bestätigt hat.

Fehlercodes

• 401 — API-Key ungültig oder widerrufen.
• 403 — der Key darf nur auslösen; für die Statusabfragen einen Key mit Leserechten anlegen.
• 409 — keine aktiven Geräte im Account.
• 429 — Rate-Limit erreicht.