live24h REST API
Die live24h API ermöglicht Ihnen den programmatischen Zugriff auf alle Funktionen der Plattform. Die API ist ab dem Pro-Tarif verfügbar.
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 löschen |
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 zurückgegeben:
{
"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 Überschreitung erhalten Sie einen 429 Too Many Requests Status.
Fehlerbehandlung
| Status | Bedeutung |
|---|---|
400 | Ungültige Anfrage |
401 | Fehlende oder ungültige Authentifizierung |
404 | Ressource nicht gefunden |
429 | Rate Limit überschritten |
500 | Interner Serverfehler |