Skip to content
cronitorex.com

Przegląd API

Cronitorex udostępnia dwa API, każde z własnym kluczem API:

APIBase URLPrefiks kluczaZastosowanie
Ingest APIhttps://api.cronitorex.comck_Odbiór zdarzeń monitoringowych (pingów) z Twoich jobów i usług
Management APIhttps://app.cronitorex.com/api/v1mk_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:

APILimitPo przekroczeniu
Ingest API10 zapytań/sekundę, burst 20429 Too Many Requests
Management API60 zapytań/minutę na klucz API429 + nagłówki X-RateLimit-Limit / X-RateLimit-Remaining

Endpointy

Ingest API

MetodaŚcieżkaOpis
POST/pingWyślij zdarzenie monitoringowe — zobacz POST /ping
GET/ping/{monitor}Wyślij zdarzenie przez query params — zobacz GET /ping
GET/healthHealthcheck API (bez autoryzacji)

Słownik statusów i typy zdarzeń: Typy zdarzeń i statusy.

Management API

MetodaŚcieżkaOpis
GET/api/v1/monitorsLista manifestów monitorów (filtr ?kind=)
GET/api/v1/monitors/{uuid}Odczyt pojedynczego monitora
POST/api/v1/monitorsUtworzenie 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