Website erstellen

POST /api/websites

Beispiel (cURL)Ankerlink kopieren

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

curl -X POST "$BASE_URL/api/websites" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "customerId": "059e1469-0f05-4c93-bd4d-89c45bb2afd9",
    "name": "Neue Landing Page",
    "url": "https://landing.deinkunde.com",
    "monitoringType": "combined",
    "checkInterval": 5
  }'

Beispiel (cURL): ErsatzzielAnkerlink kopieren

Misst den Origin hinter einer WAF/CDN, indem die Verbindung zu einem anderen Host geht als in url steht - URL, Pfad, Host-Header und TLS-SNI bleiben der öffentliche Hostname:

curl -X POST "$BASE_URL/api/websites" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"customerId":"...","name":"Shop (Origin)","url":"https://shop.example.com","connectHost":"origin.example.com","connectTlsInsecure":true}'

Anfrage (Request Body)Ankerlink kopieren

KernfelderAnkerlink kopieren

AuthentifizierungAnkerlink kopieren

HTTP-Anfrage konfigurierenAnkerlink kopieren

QUERY ist sicher und idempotent wie GET, trägt aber einen Anfragekörper. Gedacht für die Fälle, in denen heute POST steht, obwohl nur gelesen wird: Suchen, Filter, GraphQL-artige Abfragen. Ein serverseitiges Regelwerk, das POST als schreibenden Zugriff behandelt, sieht die Prüfung damit nicht mehr als solchen.

ErsatzzielAnkerlink kopieren

Nicht verfügbar für playwright-Szenarien und heartbeat-Monitore: beide durchlaufen nicht die HTTP/SSL-Prüfkette, in die connectHost eingreift - die Felder werden angenommen, wirken sich bei diesen Monitor-Arten aber nicht aus.

Ist checkHttpsRedirectEnabled eingeschaltet, folgt auch die Prüfung "leitet http auf https um" dem connectHost und misst damit ebenfalls den Origin. Weil diese Umleitung meist die WAF übernimmt und nicht der Origin, kann der Monitor dadurch zu Recht rot werden, obwohl die öffentliche Seite die Umleitung korrekt ausliefert.

mTLS (gegenseitiges TLS)Ankerlink kopieren

Playwright-MonitoringAnkerlink kopieren

Erwartete Antwort prüfenAnkerlink kopieren

Prüfungen ein- und ausschaltenAnkerlink kopieren

Das Paket der Organisation kann einzelne Prüfungen verbieten: wird für eine verbotene Prüfung true gesendet, entsteht der Monitor still mit dieser Prüfung auf false.

Schwellen für Zertifikat und DomainAnkerlink kopieren

Grenzen der SeitengrößeAnkerlink kopieren

DNS-MonitoringAnkerlink kopieren

HeartbeatAnkerlink kopieren

Antwort (Response)Ankerlink kopieren

Gibt den angelegten Website-Datensatz zurück. Die verschlüsselt gespeicherten Felder (authorizationHeader, basicAuthPassword, customHeaders, requestBody, mtlsClientCert, mtlsClientKey) gibt die API grundsätzlich nicht heraus.

{
  "id": 103,
  "customerId": 1,
  "name": "Neue Landing Page",
  "url": "https://landing.deinkunde.com",
  "status": "active",
  "monitoringType": "combined",
  "checkInterval": 5,
  "httpMethod": "GET",
  "followRedirects": true,
  "cookieHandling": "none",
  "mtlsEnabled": false,
  "connectHost": null,
  "connectPort": null,
  "connectTlsInsecure": false,
  "createdAt": "2026-02-26T12:05:00.000Z"
}

GET /api/websites/:id und GET /api/websites geben connectHost, connectPort und connectTlsInsecure genauso zurück.

Häufige FehlerAnkerlink kopieren

• 401 Unauthorized, wenn du nicht angemeldet bist
• 403 Forbidden, wenn du für diese Organisation oder diesen Kunden keine Websites anlegen darfst
• 403 Forbidden (selfServiceNotAllowed), wenn ein kunden-gescopter Aufrufer einen Monitor anlegt, das aufgelöste allowSelfService des Kunden aber false ist
• 403 Forbidden (selfServiceQuotaReached), wenn die Zahl der Self-Service-Monitore des Kunden über alle Monitor-Typen hinweg maxSelfServiceUrls bereits erreicht
• 404 Customer not found, wenn sich customerId keinem bestehenden Kunden zuordnen lässt
• 400 Bad Request (connectHostInvalid), wenn connectHost kein gültiger Host ist oder Protokoll bzw. Pfad enthält
• 400 Bad Request (connectHostNotPublic), wenn connectHost auf eine private, Loopback-, Link-Local- oder sonst gesperrte Adresse auflöst
• 400 Bad Request (connectTlsInsecureWithoutHost), wenn connectTlsInsecure ohne connectHost gesendet wird
• 403 Forbidden mit data.code paidQuotaUpgradeNotAuthorized, wenn der Aufruf aus einer Agentenverbindung (MCP) kommt, die Organisation an ihrer Monitorgrenze steht und selbst hochstuft, und allowPaidQuotaUpgrade nicht auf true steht. Der Monitor hätte die Organisation auf die nächste, teurere Stufe gehoben und die Differenz für den Rest des Zeitraums abgerechnet; die Meldung nennt Stufe und Monatspreis. Wiederhole den Aufruf mit allowPaidQuotaUpgrade: true, sobald ein Mensch der höheren Rechnung zugestimmt hat, oder gib vorher einen Monitor frei.