Eskalations-Konfiguration testen
Testet die Eskalations-Konfiguration, indem ein Test-Webhook, ein PagerDuty-Event oder eine Pushover-Benachrichtigung gesendet wird. Alle Body-Felder sind optional und überschreiben für den Test die in der DB gespeicherten Werte.
POST /api/escalation-config/:id/test
Anfrage (Request Body) (alle optional)
| Feld | Typ | Beschreibung |
|---|---|---|
type | string | pagerduty oder pushover für dedizierte Handler |
config | object | PagerDuty-Konfiguration {routingKey} oder Pushover-Konfiguration {userKey, apiToken} |
webhookUrl | string | Überschreibt die Webhook-URL für den Test |
webhookMethod | string | Überschreibt die Webhook-Methode |
webhookHeaders | object | Überschreibt die Webhook-Header. Dieselbe Sperrliste wie beim PATCH: Host antwortet 400 webhookHostHeaderForbidden; Authorization, Cookie, X-Forwarded-* und Proxy-* antworten 400 invalidRequestBody. |
webhookBodyTemplate | string | Überschreibt die Webhook-Body-Vorlage |
webhookTimeout | number | Überschreibt das Webhook-Timeout |
expectedStatusCodes | string | Überschreibt die erwarteten Statuscodes |
Beispiel (cURL): Webhook-Test
curl -X POST "$BASE_URL/api/escalation-config/1/test" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"webhookUrl": "https://httpbin.org/post",
"webhookMethod": "POST",
"webhookTimeout": 15
}'Beispiel (cURL): PagerDuty-Test
curl -X POST "$BASE_URL/api/escalation-config/1/test" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "pagerduty",
"config": { "routingKey": "your-routing-key-here" }
}'Antwort (Response) (Webhook)
{ "success": true, "statusCode": 200, "message": "Webhook delivered successfully" }Antwort (Response) (PagerDuty)
{ "success": true, "message": "PagerDuty event enqueued successfully" }Häufige Fehler
401 Unauthorizedwenn du nicht angemeldet bist400(organizationIdRequired), wenn die Organisations-ID fehlt oder keine positive Ganzzahl ist. Seit dem 20.10.2026 erst nach der Anmeldung geprüft; vorher kam400auch ohne Sitzung.403 Forbidden(forbidden), wenn du nicht Organisations-Admin bist, oder (customerScopedTokenForbidden), wenn dein Umfang auf Kunden beschränkt ist. Der zweite Fall ist seit dem 20.10.2026 neu, wie beiGETundPATCH.
Eskalations-Konfiguration abrufen
Gibt die Eskalations-Konfiguration einer Organisation zurück. Der Parameter :id ist die Organisations-ID. Ist noch keine Konfiguration gespeichert, kommen die inaktiven Standardwerte zurück (`id`, `createdAt` und `updatedAt` sind `null`), angelegt wird nichts; der erste PATCH speichert sie.
Eskalations-Konfiguration aktualisieren
Aktualisiert die Eskalations-Konfiguration. Der Parameter :id ist die Organisations-ID. Falls noch keine Konfiguration existiert, wird per Upsert eine angelegt.