Skip to content
cronitorex.com
Cronitorex Cronitorex

API-Überblick

Cronitorex stellt zwei APIs bereit, jede mit ihrem eigenen API-Schlüssel:

APIBasis-URLSchlüsselpräfixZweck
Ingest APIhttps://api.cronitorex.comck_Empfängt Monitoring-Events (Pings) von deinen Jobs und Services
Management APIhttps://app.cronitorex.com/api/v1mk_Verwaltet Monitore als Manifest-Dokumente: auflisten, abrufen, erstellen, aktualisieren

Authentifizierung

Beide APIs authentifizieren mit einem Bearer-Token, aber jede verwendet ihren eigenen Schlüssel:

Authorization: Bearer <api_key>
  • Der Ingest-API-Schlüssel (ck_...) authentifiziert nur Pings.
  • Der Management-API-Schlüssel (mk_...) authentifiziert nur /api/v1.

Generiere beide Schlüssel im Panel unter Einstellungen → API-Schlüssel. Die Ingest API akzeptiert zusätzlich einen ?api_key=-Query-Parameter für Ad-hoc-GET-Pings (siehe GET /ping).

Content-Type

Alle Request-Bodies müssen application/json sein. Alle Antworten sind application/json.

Rate Limits

Jede API hat ihr eigenes Limit:

APILimitBei Überschreitung
Ingest API10 Anfragen/Sekunde, Burst 20429 Too Many Requests
Management API60 Anfragen/Minute pro API-Schlüssel429 + X-RateLimit-Limit / X-RateLimit-Remaining Header

Endpunkte

Ingest API

MethodePfadBeschreibung
POST/pingEin Monitoring-Event senden, siehe POST /ping
GET/ping/{monitor}Ein Event über Query-Parameter senden, siehe GET /ping
GET/healthAPI-Gesundheitscheck (keine Authentifizierung erforderlich)

Status-Vokabular und Event-Typen: Event-Typen und Status.

Management API

MethodePfadBeschreibung
GET/api/v1/monitorsMonitor-Manifeste auflisten (filtern mit ?kind=)
GET/api/v1/monitors/{uuid}Einen einzelnen Monitor abrufen
POST/api/v1/monitorsEinen Monitor aus einem Manifest erstellen
PUT/api/v1/monitors/{uuid}Einen Monitor aktualisieren (vollständiges Manifest)
DELETE/api/v1/monitors/{uuid}Nicht unterstützt, liefert 403; das Löschen ist bewusst nur im Panel möglich

Vollständige Referenz mit dem Manifest-Format: Management API.

Interaktive Tools