API-Referenz

live24h REST API

Die live24h API ermoeglicht Ihnen den programmatischen Zugriff auf alle Funktionen der Plattform. Die API ist ab dem Business-Tarif verfuegbar.

Authentifizierung

Alle API-Requests erfordern einen API-Key im Header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.live24h.eu/v1/checks

Den API-Key finden Sie in Ihren Kontoeinstellungen unter API-Zugang.

Basis-URL

https://api.live24h.eu/v1/

Endpunkte

Checks

Methode	Endpunkt	Beschreibung
`GET`	`/checks`	Alle Checks auflisten
`POST`	`/checks`	Neuen Check erstellen
`GET`	`/checks/{id}`	Check-Details abrufen
`PUT`	`/checks/{id}`	Check aktualisieren
`DELETE`	`/checks/{id}`	Check loeschen
`GET`	`/checks/{id}/history`	Check-Historie abrufen

Status Pages

Methode	Endpunkt	Beschreibung
`GET`	`/status-pages`	Alle Status Pages auflisten
`POST`	`/status-pages`	Neue Status Page erstellen
`GET`	`/status-pages/{id}`	Status Page Details

Incidents

Methode	Endpunkt	Beschreibung
`GET`	`/incidents`	Alle Incidents auflisten
`POST`	`/incidents`	Incident erstellen
`PUT`	`/incidents/{id}`	Incident aktualisieren

Beispiel: Check erstellen

curl -X POST https://api.live24h.eu/v1/checks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Meine Webseite",
    "url": "https://www.example.com",
    "type": "http",
    "interval": 60,
    "alertChannels": ["email"]
  }'

Antwortformat

Alle Antworten werden im JSON-Format zurueckgegeben:

{
  "data": {
    "id": "chk_abc123",
    "name": "Meine Webseite",
    "url": "https://www.example.com",
    "status": "up",
    "lastCheckedAt": "2025-01-15T10:30:00Z",
    "responseTime": 245
  }
}

Rate Limiting

Die API ist auf 100 Requests pro Minute begrenzt. Bei Ueberschreitung erhalten Sie einen 429 Too Many Requests Status.

Fehlerbehandlung

Status	Bedeutung
`400`	Ungueltige Anfrage
`401`	Fehlende oder ungueltige Authentifizierung
`404`	Ressource nicht gefunden
`429`	Rate Limit ueberschritten
`500`	Interner Serverfehler