Skip to Content
Uptimeify Docs

Benachrichtigungskanal testen

Testet die Konfiguration eines Benachrichtigungskanals. Sendet optional eine echte Testnachricht.

POST /api/notification-channels/test

Anfrage (Request Body)

FieldTypeRequiredDefaultDescription
typestringJa-webhook, slack, discord, pagerduty, pushover, opsgenie
configobjectJa{}Kanal-Config mit Geheimnissen
organizationIdnumberNeinaus SessionOrganisations-Scope
customerIdnumberNeinnullKunden-Scope
websiteIdnumberNeinnullWebsite-Scope
channelIdnumberNein-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.
dryRunbooleanNeinfalseFalls 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 Unauthorized wenn du nicht authentifiziert bist
  • 400 Bad Request wenn die Config für den angegebenen Typ ungültig ist
  • 400 Bad Request, wenn ein eigener Header in config.headers / config.webhookHeaders nicht erlaubt ist: Host antwortet webhookHostHeaderForbidden; 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), antworten invalidRequestBody mit dem Header in issues[].path. Authorization ist erlaubt.

Auf dieser Seite