Skip to Content
Uptimeify Docs

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)

FeldTypBeschreibung
typestringpagerduty oder pushover für dedizierte Handler
configobjectPagerDuty-Konfiguration {routingKey} oder Pushover-Konfiguration {userKey, apiToken}
webhookUrlstringÜberschreibt die Webhook-URL für den Test
webhookMethodstringÜberschreibt die Webhook-Methode
webhookHeadersobjectÜberschreibt die Webhook-Header. Dieselbe Sperrliste wie beim PATCH: Host antwortet 400 webhookHostHeaderForbidden; Authorization, Cookie, X-Forwarded-* und Proxy-* antworten 400 invalidRequestBody.
webhookBodyTemplatestringÜberschreibt die Webhook-Body-Vorlage
webhookTimeoutnumberÜberschreibt das Webhook-Timeout
expectedStatusCodesstringÜ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 Unauthorized wenn du nicht angemeldet bist
  • 400 (organizationIdRequired), wenn die Organisations-ID fehlt oder keine positive Ganzzahl ist. Seit dem 20.10.2026 erst nach der Anmeldung geprüft; vorher kam 400 auch 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 bei GET und PATCH.

Auf dieser Seite