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 Unauthorizedwenn du nicht angemeldet bist403 Forbiddenwenn du keinen Zugriff auf die Website hast403 Forbidden(checkNotInPackage), wenn ein ausdrücklichestrueeine Prüfung anschaltet, die das Paket des Kunden verbietet (data.checknennt sie)400 Bad Request(checkRequiresValue), wenncheckKeywordEnabled: trueauf eine Website ohnesearchTermtrifft odercheckSizeEnabled: truewederminPageSizenochmaxPageSizehat (data.check,data.field)404 Website not foundwenn die Website nicht existiert