Benachrichtigungskanal abfragen

GET /api/notification-channels/{id}

ZugriffAnkerlink kopieren

Dieselbe Bereichsprüfung wie beim Bearbeiten, nur lesend: Ein Website-Kanal braucht Lesezugriff auf die Website, ein Kundenkanal den Kunden in deinem Bereich (ein kundengebundener API-Token erreicht nur seinen eigenen Kunden), ein Organisationskanal Lesezugriff auf die Organisation.

Beispiel (cURL)Ankerlink kopieren

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/notification-channels/42" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Antwort (Response)Ankerlink kopieren

200 OK

{
  "id": 42,
  "organizationId": 10,
  "customerId": 5,
  "websiteId": null,
  "type": "webhook",
  "category": "alert",
  "name": "Ops webhook",
  "config": {
    "webhookUrl": "https://hooks.example.com/t/1",
    "secret": "********"
  },
  "delaySeconds": 0,
  "conditions": null,
  "allowedPackageTypes": null,
  "isActive": true,
  "verifiedAt": null,
  "createdAt": "2026-06-01T08:00:00.000Z"
}

Häufige FehlerAnkerlink kopieren

• 400 Bad Request (invalidChannelId), wenn die ID keine positive Zahl ist
• 401 Unauthorized, wenn du nicht angemeldet bist
• 403 Forbidden, wenn der Kanal außerhalb deines Bereichs liegt
• 404 Not Found (channelNotFound), wenn der Kanal nicht existiert