Change Request anlegen
Eröffnet einen Change Request gegen einen beliebigen Monitor (alle Monitor-Typen).
POST /api/monitors/:monitorType/:monitorId/change-requests
Lesezugriff auf den Monitor genügt. Der typische Aufrufer ist ein Kundenportal-Nutzer, der auf einem managed-Monitor keinen Schreibzugriff hat.
Pfad-Parameter
| Parameter | Beschreibung |
|---|---|
monitorType | Einer von website, dns, icmp, smtp, ssh, ftp, imap_pop, domain, dnsbl |
monitorId | Numerische ID des Monitors |
Request Body
| Feld | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
kind | string | Nein | change | change (Freitext-Wunsch) oder request_managed (die Org bitten, den Monitor zu übernehmen) |
message | string | Ja | - | Der Anfragetext (1-2000 Zeichen) |
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X POST "$BASE_URL/api/monitors/website/103/change-requests" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"kind": "change",
"message": "Bitte das Check-Intervall auf 1 Minute senken."
}'Response
{
"id": 12,
"status": "open"
}Häufige Fehler
400 Invalid monitor type(invalidMonitorType), wennmonitorTypekeiner der unterstützten Typen ist400 Invalid monitor identifier, wennmonitorIdkeine positive Ganzzahl ist401 Unauthorized, wenn du nicht angemeldet bist403 Forbidden/404 Not found, wenn der Monitor außerhalb deines Scopes liegt403 Forbiddenmitdata.codeauthorizingUserUnresolved, wenn der Aufruf über eine Agenten-Sitzung kommt, deren autorisierender Mensch nicht mehr auflösbar ist.requested_byistNOT NULLund zeigt auf einen echten Nutzer, es gibt also keinen Rückfallwert, und die Anfrage entsteht nicht. Autorisiere die Verbindung neu oder stelle die Anfrage aus einer Sitzung, die zu einer Person gehört.429 Too many open requests(tooManyOpenRequests), wenn der Kunde bereits 10 offene Anfragen hat