Przegląd API
Cronitorex udostępnia dwa API, każde z własnym kluczem API:
| API | Base URL | Prefiks klucza | Zastosowanie |
|---|---|---|---|
| Ingest API | https://api.cronitorex.com | ck_ | Odbiór zdarzeń monitoringowych (pingów) z Twoich jobów i usług |
| Management API | https://app.cronitorex.com/api/v1 | mk_ | Zarządzanie monitorami jako manifestami: lista, odczyt, tworzenie, aktualizacja |
Autoryzacja
Oba API autoryzują tokenem Bearer, ale każde używa własnego klucza:
Authorization: Bearer <api_key>- Klucz Ingest API (
ck_...) autoryzuje wyłącznie pingi. - Klucz Management API (
mk_...) autoryzuje wyłącznie/api/v1.
Oba klucze wygenerujesz w panelu w Ustawienia → Klucz API. Ingest API dodatkowo akceptuje parametr ?api_key= dla pingów GET ad hoc (zobacz GET /ping).
Content type
Wszystkie body zapytań muszą być application/json. Wszystkie odpowiedzi to application/json.
Limity zapytań
Każde API ma własny limit:
| API | Limit | Po przekroczeniu |
|---|---|---|
| Ingest API | 10 zapytań/sekundę, burst 20 | 429 Too Many Requests |
| Management API | 60 zapytań/minutę na klucz API | 429 + nagłówki X-RateLimit-Limit / X-RateLimit-Remaining |
Endpointy
Ingest API
| Metoda | Ścieżka | Opis |
|---|---|---|
POST | /ping | Wyślij zdarzenie monitoringowe — zobacz POST /ping |
GET | /ping/{monitor} | Wyślij zdarzenie przez query params — zobacz GET /ping |
GET | /health | Healthcheck API (bez autoryzacji) |
Słownik statusów i typy zdarzeń: Typy zdarzeń i statusy.
Management API
| Metoda | Ścieżka | Opis |
|---|---|---|
GET | /api/v1/monitors | Lista manifestów monitorów (filtr ?kind=) |
GET | /api/v1/monitors/{uuid} | Odczyt pojedynczego monitora |
POST | /api/v1/monitors | Utworzenie monitora z manifestu |
PUT | /api/v1/monitors/{uuid} | Aktualizacja monitora (pełny manifest) |
DELETE | /api/v1/monitors/{uuid} | Niedostępne — zwraca 403; usuwanie celowo tylko z panelu |
Pełna referencja z formatem manifestu: Management API.
Narzędzia interaktywne
- Swagger UI — wypróbuj oba API w przeglądarce
- Kolekcja Postman — gotowe requesty dla wszystkich endpointów