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.
GET /api/escalation-config/:id
Gibt außerdem die Standard-Benachrichtigungseinstellungen der Organisation sowie alle Benachrichtigungskanäle zurück.
Header-Werte kommen nie zurück: webhookHeaders enthält die Header-Namen mit null als Wert, und hasWebhookHeaders sagt, ob Header gespeichert sind. Dasselbe gilt für config.headers der Kanäle in notificationChannels (Namen mit null, dazu hasHeaders). Gespeichert werden Header-Werte verschlüsselt.
Beispiel (cURL)
curl -X GET "$BASE_URL/api/escalation-config/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Antwort (Response)
{
"id": 1,
"organizationId": 1,
"webhookUrl": "https://deinkunde.com/webhook",
"webhookMethod": "POST",
"webhookHeaders": { "Content-Type": null },
"hasWebhookHeaders": true,
"webhookBodyTemplate": "{\"websiteName\":\"{{websiteName}}\",...}",
"webhookTimeout": 30,
"webhookRetryAttempts": 3,
"webhookRetryDelay": 60,
"expectedStatusCodes": "200,201,202,204",
"isActive": false,
"lastTestedAt": null,
"lastTestStatus": null,
"lastTestError": null,
"organization": {
"defaultEmail": "ops@deinkunde.com",
"defaultPhoneNumber": "+1234567890",
"defaultNotificationChannels": null,
"defaultNotificationTargets": null,
"defaultNotificationRules": null
},
"notificationChannels": []
}Häufige Fehler
401 Unauthorizedwenn du nicht angemeldet bist403 Forbidden, wenn du nicht Organisations-Admin mit unbeschränktem Umfang bist (forbidden, bzw.customerScopedTokenForbiddenfür ein kundengebundenes Token oder einen Kunden-Login). Die Antwort enthält Webhook-URL, -Header und -Vorlage, deshalb reicht Leserecht nicht.
Eskalations-Konfiguration
Verwalte die Webhook-Eskalationseinstellungen auf Organisationsebene sowie die Standard-Benachrichtigungskanäle.
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.