Benachrichtigungskanal testen
Testet die Konfiguration eines Benachrichtigungskanals. Sendet optional eine echte Testnachricht.
POST /api/notification-channels/test
Anfrage (Request Body)
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
type | string | Ja | - | webhook, slack, discord, pagerduty, pushover, opsgenie |
config | object | Ja | {} | Kanal-Config mit Geheimnissen |
organizationId | number | Nein | aus Session | Organisations-Scope |
customerId | number | Nein | null | Kunden-Scope |
websiteId | number | Nein | null | Website-Scope |
channelId | number | Nein | - | Bestehender Kanal, der getestet wird. Ein Header in config mit Wert null oder "" nimmt dann den gespeicherten Wert dieses Kanals (braucht Bearbeitungsrecht am Kanal). Ohne channelId fällt ein solcher Header weg. |
dryRun | boolean | Nein | false | Falls true, wird nur validiert (kein tatsächliches Senden) |
Beispiel (cURL)
curl -X POST "$BASE_URL/api/notification-channels/test" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "webhook",
"config": {
"url": "https://deinkunde.com/webhook",
"method": "POST",
"timeout": 15
},
"dryRun": false
}'Antwort (Response)
{
"success": true,
"mode": "send",
"message": "Webhook delivered successfully",
"validation": { "ok": true, "errors": [], "warnings": [] },
"request": { "url": "https://deinkunde.com/webhook", "method": "POST", "timeoutSeconds": 15, "headers": {}, "bodyPreview": "...", "bodySize": 256 },
"response": { "reachable": true, "ok": true, "statusCode": 200, "statusText": "OK", "durationMs": 150, "headers": {}, "bodyPreview": null, "bodySize": null }
}HTTP-429-Antworten werden als „erreichbar, aber rate-limitiert" behandelt (success: true).
Häufige Fehler
401 Unauthorizedwenn du nicht authentifiziert bist400 Bad Requestwenn die Config für den angegebenen Typ ungültig ist400 Bad Request, wenn ein eigener Header inconfig.headers/config.webhookHeadersnicht erlaubt ist:HostantwortetwebhookHostHeaderForbidden; ein Name, der kein gültiger HTTP-Headername ist, ein Wert mit Zeilenumbruch oder anderem Steuerzeichen und die Header, die der Versand selbst setzt (Content-Length,Transfer-Encoding,Connection,Keep-Alive,Upgrade,TE,Trailer,Expect,Proxy-Connection), antworteninvalidRequestBodymit dem Header inissues[].path.Authorizationist erlaubt.