live24h REST API
API live24h umożliwia programistyczny dostęp do wszystkich funkcji platformy. API jest dostępne od planu Business.
Uwierzytelnianie
Wszystkie zapytania API wymagają klucza API w nagłówku:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.live24h.eu/v1/checks
Klucz API znajdziesz w ustawieniach konta w sekcji Dostęp do API.
Bazowy URL
https://api.live24h.eu/v1/
Endpointy
Checks
| Metoda | Endpoint | Opis |
|---|---|---|
GET | /checks | Lista wszystkich checków |
POST | /checks | Utworzenie nowego checku |
GET | /checks/{id} | Pobranie szczegółów checku |
PUT | /checks/{id} | Aktualizacja checku |
DELETE | /checks/{id} | Usunięcie checku |
GET | /checks/{id}/history | Pobranie historii checku |
Status Pages
| Metoda | Endpoint | Opis |
|---|---|---|
GET | /status-pages | Lista wszystkich Status Pages |
POST | /status-pages | Utworzenie nowej Status Page |
GET | /status-pages/{id} | Szczegóły Status Page |
Incidents
| Metoda | Endpoint | Opis |
|---|---|---|
GET | /incidents | Lista wszystkich incydentów |
POST | /incidents | Utworzenie incydentu |
PUT | /incidents/{id} | Aktualizacja incydentu |
Przykład: Tworzenie checku
curl -X POST https://api.live24h.eu/v1/checks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Moja strona",
"url": "https://www.example.com",
"type": "http",
"interval": 60,
"alertChannels": ["email"]
}'
Format odpowiedzi
Wszystkie odpowiedzi są zwracane w formacie JSON:
{
"data": {
"id": "chk_abc123",
"name": "Moja strona",
"url": "https://www.example.com",
"status": "up",
"lastCheckedAt": "2025-01-15T10:30:00Z",
"responseTime": 245
}
}
Rate Limiting
API jest ograniczone do 100 zapytań na minutę. Po przekroczeniu limitu otrzymasz status 429 Too Many Requests.
Obsługa błędów
| Status | Znaczenie |
|---|---|
400 | Nieprawidłowe zapytanie |
401 | Brak lub nieprawidłowe uwierzytelnianie |
404 | Zasób nie znaleziony |
429 | Przekroczony limit zapytań |
500 | Wewnętrzny błąd serwera |