Wer hat Bereitschaft

GET /api/im/on-call

Liefert, wer gerade jetzt Bereitschaft hat: ein Eintrag pro Schedule deiner Organisation. Dies ist eine Zeitstempel-Abfrage gegen die materialisierten Schichten (im_schedule_shift), also dieselbe Tabelle, die auch die Eskalations-Engine liest, um zu entscheiden, wer alarmiert wird; es wird keine Rotationslogik live neu berechnet.

Authentifizierung

Erfordert den Basis-IM-Zugriff, den jeder Endpunkt dieser API benötigt (eine der IM-berechtigten Rollen admin, editor oder responder, oder einen organisationsweiten API-Token; Incident Management muss für die Organisation aktiviert sein).

Beispiel (cURL)

curl -X GET "$BASE_URL/api/im/on-call" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Antwort (Response)

200 OK: ein Array, ein Eintrag pro Schedule mit aktueller Abdeckung. Ein Schedule ohne aktuelle Abdeckung (eine Lücke) fehlt schlicht im Array. Er wird nicht als null oder Fehler zurückgegeben.

[
  {
    "teamId": 3,
    "scheduleId": 7,
    "userId": "u_abc123",
    "userName": "Jane Doe",
    "shiftEndsAt": "2026-07-18T09:00:00.000Z"
  }
]

Überlappen sich bei einem Schedule mehrere Rotationsschichten, gewinnt die gerade aktive höchste Schicht. Es gilt dieselbe Regel „höhere Schicht sticht niedrigere", nach der auch die Eskalations-Engine auflöst, sodass dieser Endpunkt nie widersprüchlich zu dem ist, wer tatsächlich alarmiert wird. shiftEndsAt ist der Zeitpunkt, zu dem die aktuelle Schicht (oder der Override) endet, also die nächste Übergabe für diesen Schedule.

Häufige Fehler

• 401 Unauthorized wenn du nicht authentifiziert bist
• 403 Forbidden (imAccessDenied) bei Verwendung eines kunden-gescopten Tokens, oder wenn deine Session keine IM-berechtigte Rolle hat
• 403 Forbidden (imNotEnabled) wenn Incident Management für die Organisation nicht aktiviert ist