Skip to Content
Uptimeify Docs

Check-Einstellungen aktualisieren

Konfiguriere, welche Aspekte der Website überwacht werden sollen.

PATCH /api/websites/:websiteId/check-config

Wer checkKeywordEnabled anschaltet, obwohl die Website keinen searchTerm hat, oder checkSizeEnabled, obwohl weder minPageSize noch maxPageSize gesetzt ist, bekommt 400 checkRequiresValue: ohne diese Werte messen die beiden Prüfungen nichts. searchTerm gehört nicht in diesen Body, es zählt der gespeicherte; für die Seitengrössen zählt der Wert aus dem Body, sonst der gespeicherte. Eine schon laufende Prüfung wird abgeschaltet, wenn ihr Wert fehlt.

Anfrage (Request Body)

{
  "checkSslEnabled": true,
  "checkHttpsRedirectEnabled": true,
  "checkStatusEnabled": true,
  "checkSizeEnabled": true,
  "checkResponseTimeEnabled": true,
  "checkKeywordEnabled": false,
  "checkDomainExpiryEnabled": true,
  "minPageSize": 1024, // in Bytes (optional)
  "maxPageSize": 5242880 // in Bytes (optional)
}

Das Paket der Organisation kann eine Prüfung verbieten. Ein true, das eine solche Prüfung anschaltet, antwortet 403 mit data.code checkNotInPackage, data.check nennt das Feld; das Paket wird vor dem fehlenden Wert geprüft. Ein true für eine Prüfung, die an dieser Website schon läuft (oder nie gesetzt war), bleibt erlaubt, auch wenn das Paket sie inzwischen verbietet, und das Paket schaltet sie nie ab. false ist immer erlaubt.

Beispiel (cURL)

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

curl -X PATCH \
  "$BASE_URL/api/websites/101/check-config" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"checkSslEnabled":true,"checkHttpsRedirectEnabled":true,"checkStatusEnabled":true,"checkSizeEnabled":true,"checkResponseTimeEnabled":true,"checkKeywordEnabled":false,"minPageSize":1024,"maxPageSize":5242880}'

Beispiel-Antwort

{
  "success": true
}

Häufige Fehler

  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden wenn du keinen Zugriff auf die Website hast
  • 403 Forbidden (checkNotInPackage), wenn ein ausdrückliches true eine Prüfung anschaltet, die das Paket des Kunden verbietet (data.check nennt sie)
  • 400 Bad Request (checkRequiresValue), wenn checkKeywordEnabled: true auf eine Website ohne searchTerm trifft oder checkSizeEnabled: true weder minPageSize noch maxPageSize hat (data.check, data.field)
  • 404 Website not found wenn die Website nicht existiert

Auf dieser Seite