CronLuma
CRONLUME PROFESSIONAL API · V1

Budowanie, obsługa i odzyskiwanie
Każdy cron przez API.

Kompletna konsola do testów na żywo dla profesjonalnych operacji cron. Podłącz dedykowany klucz API, edytuj rzeczywiste parametry i sprawdź dokładną odpowiedź zwróconą przez przestrzeń roboczą CronLume.

25 udokumentowane operacjeJSON Organ wnioskujący i organ udzielający odpowiedziPosiadacz uwierzytelnienie
URL PODSTAWY PRODUKCJIhttps://api.cronlume.com/v1HEADER AUTENTYCZNYAuthorization: Bearer crl_live_…

Klucze są tworzone i cofane pod Deska rozdzielcza → Klucze API.

⌁
LIVE API KONSOLE

Podłącz klawisz API

Klucz pozostaje w pamięci tej strony i jest wysyłany tylko do punktu końcowego wyraźnie testowanego. Nigdy nie jest dodawany do przykładów, adresów URL lub pamięci masowej przeglądarki.

Niepołączone
API DOMAIN

Uwierzytelnienie

Zweryfikuj referencje i zidentyfikuj aktywną przestrzeń roboczą.

GET/account

Weryfikacja połączenia API

Potwierdź klucz Posiadacza i zwróć uwierzytelnioną tożsamość klucza API i przestrzeń roboczą. Interaktywna konsola wykorzystuje ten punkt końcowy przy wyborze Connect.

ZezwolenieKażdy aktywny klucz API

Przykład wniosku

curl -X GET "https://api.cronlume.com/v1/account" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": {
        "workspace": {
            "id": "81f9349b-8fd2-41ed-816a-4c673603b951",
            "name": "Acme Operations",
            "plan": "professional"
        },
        "api_key": {
            "id": "1cf3ef95-65c9-44d3-90e2-c473c0ff7a39",
            "name": "Production automation",
            "prefix": "crl_live_a8f94d",
            "last_used_at": "2026-08-28 20:08:31.000000"
        },
        "user": {
            "id": "f6e4f785-cbbe-45db-b179-467dcf61337d",
            "name": "Alex Morgan",
            "email": "alex@example.com"
        }
    }
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
API DOMAIN

Miejsca pracy na wronie

Tworzenie, kontrola, harmonogram i kontrola operacji cron HTTP.

GET/crons

Lista i wyszukiwanie miejsc pracy cron

Zwraca pracę w trybie pilnym. Połącz filtry, aby szybko zlokalizować projekt, stan incydentu lub punkt końcowy.

ZezwolenieKażdy klucz API

Pole zapytania

Parametry zapytania
searchciągOpcjonalnie

Tytuł wyszukiwania, adres URL i opis.

Przykład: invoices
statusenumOpcjonalnie

w toku, zdrowy, zdegradowany, w dół lub zatrzymany.

Przykład: down
activebooleanOpcjonalnie

Filtruj aktywne lub niepełnosprawne zadania.

Przykład: true
group_idUUIDOpcjonalnie

Filtruj według projektu / grupy strony.

category_idUUIDOpcjonalnie

Filtruj według kategorii.

limitliczba całkowitaOpcjonalnie

1-100. Domyślnie 50.

Przykład: 50
offsetliczba całkowitaOpcjonalnie

Przesunięcie poprzeczne. Domyślnie 0.

Przykład: 0

Przykład wniosku

curl -X GET "https://api.cronlume.com/v1/crons?search=invoices&status=down&active=true&group_id=&category_id=&limit=50&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": [
        {
            "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "name": "Generate customer invoices",
            "description": "Creates invoices for completed billing periods.",
            "criticality": "critical",
            "url": "https://billing.example.com/tasks/invoices",
            "method": "POST",
            "cron_expression": "*/15 * * * *",
            "timezone": "Europe/Brussels",
            "timeout_seconds": 180,
            "failure_threshold": 3,
            "failure_action_enabled": true,
            "failure_action_threshold": 3,
            "failure_action_url": "https://backup.example.com/recover/invoices",
            "is_active": true,
            "current_status": "healthy",
            "next_run_at": "2026-08-28 20:15:00.000000",
            "last_run_at": "2026-08-28 20:00:00.000000",
            "consecutive_failures": 0,
            "group_name": "Billing platform",
            "category_ids": [
                "125976d5-c276-481c-984c-a9b4b70e477e"
            ]
        }
    ],
    "pagination": {
        "total": 1,
        "limit": 50,
        "offset": 0
    }
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
POST/crons

Utwórz pracę cron

Utwórz w pełni monitorowany harmonogram HTTP. Wymagane pola są celowo minimalne; każde zabezpieczenie operacyjne można skonfigurować w tym samym wniosku.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Ciało JSON
nameciągWymagane

Tytuł do odczytu humanistycznego używany w poszukiwaniu, ostrzeżeniach i harmonogramach zdarzeń.

Przykład: Generate customer invoices
urlURLWymagane

Punkt końcowy HTTP lub HTTPS wezwany przez pracownika wykonującego. Nigdy nie umieszczaj referencji w URL.

Przykład: https://billing.example.com/tasks/invoices
cron_expressionciągWymagane

Standardowe wyrażenie 5-pole crontab: minuta, godzina, dzień miesiąca, miesiąc i dzień tygodnia.

Przykład: */15 * * * *
descriptionciągOpcjonalnie

Cel operacyjny i bezpieczny kontekst dla respondentów. Maksymalnie 600 znaków.

Przykład: Creates invoices for completed billing periods.
criticalityenumOpcjonalnie

standardowe, ważne lub krytyczne. Domyślnie ważne.

Przykład: critical
methodenumOpcjonalnie

GET, POST, PUT, PATCH, DELETE or HEAD. Domyślnie GET.

Przykład: POST
headersobiektOpcjonalnie

nagłówki zapytań HTTP. Zaszyfrowany. Nie włączaj ich do wniosków o wsparcie.

Przykład: {"Authorization":"Bearer service-token"}
bodyciągOpcjonalnie

Raw HTTP wniosek organ wysłany do punktu końcowego.

Przykład: {"source":"cronlume"}
group_idUUID Xi124; nullOpcjonalnie

Istniejąca grupa w tym samym miejscu pracy.

category_idsUUID []Opcjonalnie

Istniejące identyfikatory kategorii w tym samym miejscu pracy.

Przykład: []
timezoneStrefa czasowa IANAOpcjonalnie

Strefa czasowa stosowana do oceny ekspresji cron. Domyślnie UTC.

Przykład: Europe/Brussels
timeout_secondsliczba całkowitaOpcjonalnie

Maksymalny całkowity czas trwania wniosku. Długoterminowe punkty końcowe są obsługiwane. Domyślnie 120.

Przykład: 180
connect_timeout_secondsliczba całkowitaOpcjonalnie

Maksymalny czas trwania połączenia. Domyślnie 15.

Przykład: 20
follow_redirectsbooleanOpcjonalnie

Podążaj za przekierowaniem HTTP. Domyślnie prawdziwe.

Przykład: 1
verify_tlsbooleanOpcjonalnie

Weryfikacja zdalnego certyfikatu TLS. Utrzymać włączone w produkcji.

Przykład: 1
expected_status_minliczba całkowitaOpcjonalnie

Najniższy status HTTP uważany za udany. Domyślnie 200.

Przykład: 200
expected_status_maxliczba całkowitaOpcjonalnie

Najwyższy status HTTP uważany za udany. Domyślnie 399.

Przykład: 399
max_retriesliczba całkowitaOpcjonalnie

Dodatkowe próby po nieudanej prośbie. Domyślnie 2.

Przykład: 2
retry_backoff_secondsliczba całkowitaOpcjonalnie

Opóźnienie między ponownymi próbami. Domyślnie 30.

Przykład: 30
failure_thresholdliczba całkowitaOpcjonalnie

Konsekwentnie nieudane egzekucje przed uznaniem pracy za nieudaną. Domyślnie 2.

Przykład: 3
recovery_thresholdliczba całkowitaOpcjonalnie

Konsekwentne sukcesy potrzebne do rozwiązania incydentu. Domyślnie 1.

Przykład: 1
alert_repeat_minutesliczba całkowitaOpcjonalnie

Powtarzać interwał dla trwałych wpisów o incydentach. Domyślnie 15.

Przykład: 15
grace_secondsliczba całkowitaOpcjonalnie

Okres karencji przed nieudanym biegiem jest uważany za późny. Domyślnie 60.

Przykład: 60
alert_on_pausebooleanOpcjonalnie

Wysyłanie alarmów, gdy zadanie jest automatycznie lub ręcznie wyłączone. Domyślnie prawdziwe.

Przykład: 1
failure_action_enabledbooleanOpcjonalnie

Wywołaj awaryjny URL po osiągnięciu skonfigurowanej passy błędów.

Przykład: 1
failure_action_thresholdliczba całkowitaOpcjonalnie

Liczenie awarii, które uruchamia awaryjny URL. Zakres 1-20.

Przykład: 3
failure_action_urlURL presentable 124; nullOpcjonalnie

Awaryjny adres HTTP (S). Musi się różnić od głównego adresu URL.

Przykład: https://backup.example.com/recover/invoices
is_activebooleanOpcjonalnie

Utwórz zadanie aktywne lub wstrzymane. Domyślnie prawdziwe.

Przykład: 1

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/crons" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Generate customer invoices",
    "url": "https://billing.example.com/tasks/invoices",
    "cron_expression": "*/15 * * * *",
    "timezone": "Europe/Brussels",
    "method": "POST",
    "timeout_seconds": 180,
    "criticality": "critical",
    "failure_threshold": 3,
    "alert_on_pause": true,
    "failure_action_enabled": true,
    "failure_action_threshold": 3,
    "failure_action_url": "https://backup.example.com/recover/invoices"
}'

Przykład odpowiedzi

201
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "healthy",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Możliwe odpowiedzi

201Utworzono zadanie Cron
401Nieprawidłowy klucz API
422Brak pola, nieprawidłowe wyrażenie cron lub nieprawidłowy URL awaryjny
Przygotowanie interaktywnego formularza testowego...
GET/crons/{cron_id}

Odzyskać jedną pracę cron

Zwróć pełną konfigurację i aktualny stan operacyjny, w tym rozszyfrowane nagłówki zapytań do autoryzowanego użytkowania technicznego. Traktuj odpowiedź jako wrażliwą.

ZezwolenieKażdy klucz API

Pole zapytania

Parametry ścieżki
cron_idŚcieżka UUIDWymagane

Identyfikator zadania Cron.

Przykład: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Przykład wniosku

curl -X GET "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "healthy",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Możliwe odpowiedzi

200Zwrócone zadanie Cron
401Nieprawidłowy klucz API
404Cron zadanie nie znaleziono w tym miejscu pracy
Przygotowanie interaktywnego formularza testowego...
PATCH/crons/{cron_id}

Zmień konfigurację cron

Uaktualnij jedno lub więcej obsługiwanych pól. Zakazane pola zachowują aktualne wartości. Zmiana harmonogramu lub strefy czasowej ponownie oblicza następny _ run _ at.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
cron_idŚcieżka UUIDWymagane

Identyfikator zadania Cron.

Przykład: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Ciało JSON
nameciągOpcjonalnie

Tytuł do odczytu humanistycznego używany w poszukiwaniu, ostrzeżeniach i harmonogramach zdarzeń.

Przykład: Generate customer invoices
urlURLOpcjonalnie

Punkt końcowy HTTP lub HTTPS wezwany przez pracownika wykonującego. Nigdy nie umieszczaj referencji w URL.

Przykład: https://billing.example.com/tasks/invoices
cron_expressionciągOpcjonalnie

Standardowe wyrażenie 5-pole crontab: minuta, godzina, dzień miesiąca, miesiąc i dzień tygodnia.

Przykład: */15 * * * *
descriptionciągOpcjonalnie

Cel operacyjny i bezpieczny kontekst dla respondentów. Maksymalnie 600 znaków.

Przykład: Creates invoices for completed billing periods.
criticalityenumOpcjonalnie

standardowe, ważne lub krytyczne. Domyślnie ważne.

Przykład: critical
methodenumOpcjonalnie

GET, POST, PUT, PATCH, DELETE or HEAD. Domyślnie GET.

Przykład: POST
headersobiektOpcjonalnie

nagłówki zapytań HTTP. Zaszyfrowany. Nie włączaj ich do wniosków o wsparcie.

Przykład: {"Authorization":"Bearer service-token"}
bodyciągOpcjonalnie

Raw HTTP wniosek organ wysłany do punktu końcowego.

Przykład: {"source":"cronlume"}
group_idUUID Xi124; nullOpcjonalnie

Istniejąca grupa w tym samym miejscu pracy.

category_idsUUID []Opcjonalnie

Istniejące identyfikatory kategorii w tym samym miejscu pracy.

Przykład: []
timezoneStrefa czasowa IANAOpcjonalnie

Strefa czasowa stosowana do oceny ekspresji cron. Domyślnie UTC.

Przykład: Europe/Brussels
timeout_secondsliczba całkowitaOpcjonalnie

Maksymalny całkowity czas trwania wniosku. Długoterminowe punkty końcowe są obsługiwane. Domyślnie 120.

Przykład: 180
connect_timeout_secondsliczba całkowitaOpcjonalnie

Maksymalny czas trwania połączenia. Domyślnie 15.

Przykład: 20
follow_redirectsbooleanOpcjonalnie

Podążaj za przekierowaniem HTTP. Domyślnie prawdziwe.

Przykład: 1
verify_tlsbooleanOpcjonalnie

Weryfikacja zdalnego certyfikatu TLS. Utrzymać włączone w produkcji.

Przykład: 1
expected_status_minliczba całkowitaOpcjonalnie

Najniższy status HTTP uważany za udany. Domyślnie 200.

Przykład: 200
expected_status_maxliczba całkowitaOpcjonalnie

Najwyższy status HTTP uważany za udany. Domyślnie 399.

Przykład: 399
max_retriesliczba całkowitaOpcjonalnie

Dodatkowe próby po nieudanej prośbie. Domyślnie 2.

Przykład: 2
retry_backoff_secondsliczba całkowitaOpcjonalnie

Opóźnienie między ponownymi próbami. Domyślnie 30.

Przykład: 30
failure_thresholdliczba całkowitaOpcjonalnie

Konsekwentnie nieudane egzekucje przed uznaniem pracy za nieudaną. Domyślnie 2.

Przykład: 3
recovery_thresholdliczba całkowitaOpcjonalnie

Konsekwentne sukcesy potrzebne do rozwiązania incydentu. Domyślnie 1.

Przykład: 1
alert_repeat_minutesliczba całkowitaOpcjonalnie

Powtarzać interwał dla trwałych wpisów o incydentach. Domyślnie 15.

Przykład: 15
grace_secondsliczba całkowitaOpcjonalnie

Okres karencji przed nieudanym biegiem jest uważany za późny. Domyślnie 60.

Przykład: 60
alert_on_pausebooleanOpcjonalnie

Wysyłanie alarmów, gdy zadanie jest automatycznie lub ręcznie wyłączone. Domyślnie prawdziwe.

Przykład: 1
failure_action_enabledbooleanOpcjonalnie

Wywołaj awaryjny URL po osiągnięciu skonfigurowanej passy błędów.

Przykład: 1
failure_action_thresholdliczba całkowitaOpcjonalnie

Liczenie awarii, które uruchamia awaryjny URL. Zakres 1-20.

Przykład: 3
failure_action_urlURL presentable 124; nullOpcjonalnie

Awaryjny adres HTTP (S). Musi się różnić od głównego adresu URL.

Przykład: https://backup.example.com/recover/invoices
is_activebooleanOpcjonalnie

Utwórz zadanie aktywne lub wstrzymane. Domyślnie prawdziwe.

Przykład: 1

Przykład wniosku

curl -X PATCH "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "cron_expression": "0 */2 * * *",
    "timeout_seconds": 240,
    "failure_threshold": 4
}'

Przykład odpowiedzi

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "0 */2 * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 240,
        "failure_threshold": 4,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "healthy",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
DELETA/crons/{cron_id}

Stałe usuwanie zadania cron

Usuń zadanie i jego historię wykonania. Operacja ta jest trwała i nie zwraca żadnego organu udzielającego odpowiedzi.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
cron_idŚcieżka UUIDWymagane

Identyfikator zadania Cron.

Przykład: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Przykład wniosku

curl -X DELETE "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

204
No response body

Możliwe odpowiedzi

204Praca na wronie i związana z nią historia usunięte
401Nieprawidłowy klucz API
404Nie znaleziono zadania Cron
Przygotowanie interaktywnego formularza testowego...
POST/crons/{cron_id}/activate

Aktywować lub reaktywować cron

Czyści datę i powód pauzy, resetuje zamki i oblicza następne wykonanie.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
cron_idŚcieżka UUIDWymagane

Identyfikator zadania Cron.

Przykład: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/activate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "pending",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Możliwe odpowiedzi

200Stan Crona zmieniony
401Nieprawidłowy klucz API
404Nie znaleziono zadania Cron
Przygotowanie interaktywnego formularza testowego...
POST/crons/{cron_id}/deactivate

Wyłącz cron

Zatrzymuje przyszłe egzekucje i zapisuje dokładny czas pauzy UTC i powód API.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
cron_idŚcieżka UUIDWymagane

Identyfikator zadania Cron.

Przykład: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/deactivate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": false,
        "current_status": "paused",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Możliwe odpowiedzi

200Stan Crona zmieniony
401Nieprawidłowy klucz API
404Nie znaleziono zadania Cron
Przygotowanie interaktywnego formularza testowego...
POST/crons/{cron_id}/run

Kolejka natychmiastowej egzekucji

Przechodzi do bieżącego czasu UTC. Harmonogram przyjmuje pracę asynchronicznie.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
cron_idŚcieżka UUIDWymagane

Identyfikator zadania Cron.

Przykład: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

202
{
    "accepted": true,
    "cron_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
}

Możliwe odpowiedzi

202Wykonanie kolejki
409Cron jest nieaktywny; aktywuj go najpierw
401Nieprawidłowy klucz API
404Nie znaleziono zadania Cron
Przygotowanie interaktywnego formularza testowego...
POST/crons/bulk-activate

Reaktywacja wielu zadań cron

Reaktywacja wybranych zadań niepełnosprawnych po awarii serwera lub rozwiązaniu incydentu. Nieznane lub już aktywne identyfikatory są ignorowane.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Ciało JSON
job_idsUUID []Wymagane

Unikalne identyfikatory koron do reaktywowania. Maksymalna zalecana partia: 200.

Przykład: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/crons/bulk-activate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "job_ids": [
        "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
    ]
}'

Przykład odpowiedzi

200
{
    "data": {
        "reactivated_ids": [
            "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
        ],
        "reactivated_count": 1,
        "ignored_count": 0
    }
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
POST/crons/{cron_id}/duplicate

Odtwarzaj cron bezpiecznie

Utwórz dokładną kopię operacyjną, w tym kategorie, kanały alarmowe, zaszyfrowane nagłówki i organ wnioskujący. Kopia jest zawsze wstrzymana i wyraźnie nazwana, więc może być poddana przeglądowi przed aktywacją bez powodowania podwójnego wykonania.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
cron_idŚcieżka UUIDWymagane

Identyfikator zadania dla koron źródłowych.

Przykład: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/duplicate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

201
{
    "data": {
        "id": "44079c1f-a0eb-45f0-b998-0c81017b2cc2",
        "name": "Generate customer invoices (copy)",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": false,
        "current_status": "paused",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ],
        "paused_at": "2026-08-29 14:22:00.000000",
        "pause_reason": "Duplicated safely through developer API \u2014 review before activation"
    }
}

Możliwe odpowiedzi

201Utworzony duplikat
401Nieprawidłowy klucz API
404Source cron job not found
Przygotowanie interaktywnego formularza testowego...
POST/crons/bulk-pause

Wstrzymać pracę wielu cron

Wstrzymać do 200 aktywnych miejsc pracy w jednej operacji. CronLume nagrywa dokładny czas pauzy UTC i developer-API powód na każdej dotkniętej pracy. Nieznane, niedostępne i już wykorzystane identyfikatory są zgłaszane jako ignorowane.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Ciało JSON
job_idsUUID []Wymagane

Unikalne identyfikatory koron do zatrzymania. Maksymalnie 200.

Przykład: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/crons/bulk-pause" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "job_ids": [
        "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
    ]
}'

Przykład odpowiedzi

200
{
    "data": {
        "paused_ids": [
            "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
        ],
        "paused_count": 1,
        "ignored_count": 0
    }
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
POST/crons/bulk-move

Przenieś wiele zadań cron do grupy

Przenieś do 200 miejsc pracy na projekt, stronę internetową, serwis lub grupę klientów. Wyślij group _ id jako null, aby wybrane zadania były niezgrupowane. Można używać tylko miejsc pracy i grup z uwierzytelnionej przestrzeni roboczej.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Ciało JSON
job_idsUUID []Wymagane

Unikalne identyfikatory koron do przeniesienia. Maksymalnie 200.

Przykład: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]
group_idUUID Xi124; nullWymagane

Identyfikator grupy docelowej lub null dla Niezgrupowanego.

Przykład: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/crons/bulk-move" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "job_ids": [
        "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
    ],
    "group_id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b"
}'

Przykład odpowiedzi

200
{
    "data": {
        "moved_ids": [
            "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
        ],
        "moved_count": 1,
        "ignored_count": 0,
        "group_id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b"
    }
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
API DOMAIN

Egzekucje

Zbadaj czas, wyniki HTTP, powtórki i działania awaryjne.

GET/crons/{cron_id}/executions

Lista historii wykonania

Sprawdź czas reakcji, status HTTP, powtórki i bezpieczne dowody odpowiedzi na jeden cron. Ostatnia egzekucja jest zwrócona pierwsza.

ZezwolenieKażdy klucz API

Pole zapytania

Parametry ścieżki
cron_idŚcieżka UUIDWymagane

Identyfikator zadania Cron.

Przykład: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Parametry zapytania
limitliczba całkowitaOpcjonalnie

1-200.

Przykład: 50

Przykład wniosku

curl -X GET "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/executions?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": [
        {
            "id": 18492,
            "job_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "scheduled_at": "2026-08-28 20:00:00.000000",
            "started_at": "2026-08-28 20:00:00.143000",
            "finished_at": "2026-08-28 20:00:01.381000",
            "duration_ms": 1238,
            "status": "succeeded",
            "attempt": 1,
            "http_status": 200,
            "error_type": null,
            "error_message": null,
            "response_excerpt": "{\"processed\":42}",
            "worker_id": "scheduler-eu-01"
        }
    ]
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
GET/crons/{cron_id}/failure-actions

Lista egzekucji z tytułu działań nadzwyczajnych

Sprawdź każde wywołanie odzyskiwania URL wywołane przez regułę konsektucyjnej awarii.

ZezwolenieKażdy klucz API

Pole zapytania

Parametry ścieżki
cron_idŚcieżka UUIDWymagane

Identyfikator zadania Cron.

Przykład: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Parametry zapytania
limitliczba całkowitaOpcjonalnie

1-200.

Przykład: 50

Przykład wniosku

curl -X GET "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/failure-actions?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": [
        {
            "id": 218,
            "job_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "trigger_failure_count": 3,
            "url": "https://backup.example.com/recover/invoices",
            "duration_ms": 842,
            "status": "succeeded",
            "http_status": 204,
            "worker_id": "scheduler-eu-01"
        }
    ]
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
API DOMAIN

Organizacja

Floty struktury według projektów, stron internetowych, usług, klientów i kategorii operacyjnej.

GET/groups

Grupy listy

Zwróć każdy projekt, stronę internetową, usługę lub inne skonfigurowane w uwierzytelnionej przestrzeni roboczej.

ZezwolenieKażdy klucz API

Przykład wniosku

curl -X GET "https://api.cronlume.com/v1/groups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": [
        {
            "id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b",
            "group_type": "service",
            "name": "Billing platform",
            "client_reference": "CLIENT-ACME-0042",
            "description": "Customer billing automation",
            "color": "#147d64"
        }
    ]
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
POST/groups

Utwórz grupę

Utwórz projekt, stronę internetową, serwis lub inne narzędzie do organizacji floty cron.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Ciało JSON
nameciągWymagane

Unikalna nazwa grupy wewnątrz przestrzeni roboczej.

Przykład: Billing platform
group_typeenumOpcjonalnie

projekt, strona internetowa, serwis lub inne.

Przykład: service
client_referenceciąg 124; nullOpcjonalnie

Klient, kontrakt lub odniesienie wewnętrzne. Maksymalnie 160 znaków.

Przykład: CLIENT-ACME-0042
descriptionciąg 124; nullOpcjonalnie

Kontekst celu i własności.

Przykład: Customer billing automation
colorkolor hexOpcjonalnie

Kolor wyświetlacza deski rozdzielczej.

Przykład: #147d64

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/groups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "group_type": "service",
    "name": "Billing platform",
    "client_reference": "CLIENT-ACME-0042",
    "description": "Customer billing automation",
    "color": "#147d64"
}'

Przykład odpowiedzi

201
{
    "data": {
        "id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b",
        "group_type": "service",
        "name": "Billing platform",
        "client_reference": "CLIENT-ACME-0042",
        "description": "Customer billing automation",
        "color": "#147d64"
    }
}

Możliwe odpowiedzi

201Grupy utworzone
401Nieprawidłowy klucz API
422Nieprawidłowe lub powielone wartości
Przygotowanie interaktywnego formularza testowego...
PATCH/groups/{group_id}

Grupa aktualizacji

Zmień jedno lub więcej pól. Przekazane pola pozostają niezmienione.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
group_idŚcieżka UUIDWymagane

Identyfikator grup.

Przykład: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b
Ciało JSON
nameciągOpcjonalnie

Unikalna nazwa grupy wewnątrz przestrzeni roboczej.

Przykład: Billing platform
group_typeenumOpcjonalnie

projekt, strona internetowa, serwis lub inne.

Przykład: service
client_referenceciąg 124; nullOpcjonalnie

Klient, kontrakt lub odniesienie wewnętrzne. Maksymalnie 160 znaków.

Przykład: CLIENT-ACME-0042
descriptionciąg 124; nullOpcjonalnie

Kontekst celu i własności.

Przykład: Customer billing automation
colorkolor hexOpcjonalnie

Kolor wyświetlacza deski rozdzielczej.

Przykład: #147d64

Przykład wniosku

curl -X PATCH "https://api.cronlume.com/v1/groups/6ef63789-baf1-44fc-99bb-0c5ce2d37a8b" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Billing platform Production"
}'

Przykład odpowiedzi

200
{
    "updated": true
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
DELETA/groups/{group_id}

Usuń grupę

Usuń element organizacyjny. Miejsca pracy pozostają dostępne; usunięte relacje grupowe stają się puste.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
group_idŚcieżka UUIDWymagane

Identyfikator grup.

Przykład: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b

Przykład wniosku

curl -X DELETE "https://api.cronlume.com/v1/groups/6ef63789-baf1-44fc-99bb-0c5ce2d37a8b" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

204
No response body

Możliwe odpowiedzi

204Skreśla się pozycję grup
401Nieprawidłowy klucz API
404Pozycja nie znaleziono
Przygotowanie interaktywnego formularza testowego...
GET/categories

Kategorie list

Zwróć każdą kategorię operacyjną skonfigurowaną w uwierzytelnionej przestrzeni roboczej.

ZezwolenieKażdy klucz API

Przykład wniosku

curl -X GET "https://api.cronlume.com/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": [
        {
            "id": "125976d5-c276-481c-984c-a9b4b70e477e",
            "name": "Billing",
            "description": "Invoice and payment workflows",
            "color": "#46769b"
        }
    ]
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
POST/categories

Utwórz kategorię

Stwórz kategorię operacyjną nadającą się do wielokrotnego użytku do organizacji floty cron.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Ciało JSON
nameciągWymagane

Unikalna nazwa kategorii wewnątrz obszaru roboczego.

Przykład: Billing
descriptionciąg 124; nullOpcjonalnie

Opis kategorii operacyjnej.

Przykład: Invoice and payment workflows
colorkolor hexOpcjonalnie

Kolor wyświetlacza deski rozdzielczej.

Przykład: #46769b

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Billing",
    "description": "Invoice and payment workflows",
    "color": "#46769b"
}'

Przykład odpowiedzi

201
{
    "data": {
        "id": "125976d5-c276-481c-984c-a9b4b70e477e",
        "name": "Billing",
        "description": "Invoice and payment workflows",
        "color": "#46769b"
    }
}

Możliwe odpowiedzi

201Kategorie utworzone
401Nieprawidłowy klucz API
422Nieprawidłowe lub powielone wartości
Przygotowanie interaktywnego formularza testowego...
PATCH/categories/{category_id}

Uaktualnij kategorię

Zmień jedno lub więcej pól. Przekazane pola pozostają niezmienione.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
category_idŚcieżka UUIDWymagane

Identyfikator kategorii.

Przykład: 125976d5-c276-481c-984c-a9b4b70e477e
Ciało JSON
nameciągOpcjonalnie

Unikalna nazwa kategorii wewnątrz obszaru roboczego.

Przykład: Billing
descriptionciąg 124; nullOpcjonalnie

Opis kategorii operacyjnej.

Przykład: Invoice and payment workflows
colorkolor hexOpcjonalnie

Kolor wyświetlacza deski rozdzielczej.

Przykład: #46769b

Przykład wniosku

curl -X PATCH "https://api.cronlume.com/v1/categories/125976d5-c276-481c-984c-a9b4b70e477e" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Billing Production"
}'

Przykład odpowiedzi

200
{
    "updated": true
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
DELETA/categories/{category_id}

Usuń kategorię

Usuń element organizacyjny. Miejsca pracy pozostają dostępne; usunięte relacje grupowe stają się puste.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
category_idŚcieżka UUIDWymagane

Identyfikator kategorii.

Przykład: 125976d5-c276-481c-984c-a9b4b70e477e

Przykład wniosku

curl -X DELETE "https://api.cronlume.com/v1/categories/125976d5-c276-481c-984c-a9b4b70e477e" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

204
No response body

Możliwe odpowiedzi

204Kategorie Pozycja usunięta
401Nieprawidłowy klucz API
404Pozycja nie znaleziono
Przygotowanie interaktywnego formularza testowego...
API DOMAIN

Zdarzenia

Czytać i uznać porażki, które wymagają profesjonalnej uwagi.

GET/incidents

Lista zdarzeń

Powrót do 500 incydentów zamówionych przez czas otwarcia. Odpowiedzi zawierają otwartą, potwierdzoną i rozwiązaną historię operacyjną.

ZezwolenieKażdy klucz API

Przykład wniosku

curl -X GET "https://api.cronlume.com/v1/incidents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "data": [
        {
            "id": 731,
            "job_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "cron_name": "Generate customer invoices",
            "status": "open",
            "severity": "critical",
            "summary": "Generate customer invoices failed 3 times",
            "details": "Remote endpoint returned HTTP 503.",
            "failure_count": 3,
            "opened_at": "2026-08-28 20:00:02.000000",
            "acknowledged_at": null,
            "resolved_at": null
        }
    ]
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...
POST/incidents/{incident_id}/acknowledge

Potwierdzenie incydentu

Zaznaczyć otwarty incydent jako potwierdzony i zapisać dokładny czas potwierdzenia UTC.

ZezwolenieKlawisz API z włączeniem zapisu

Pole zapytania

Parametry ścieżki
incident_idŚcieżka całkowitaWymagane

Identyfikator incydentu.

Przykład: 731

Przykład wniosku

curl -X POST "https://api.cronlume.com/v1/incidents/731/acknowledge" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Przykład odpowiedzi

200
{
    "acknowledged": true
}

Możliwe odpowiedzi

200Wniosek zakończony pomyślnie
401Brak, nieważność lub nieważność klucza API
403Niewystarczające pozwolenie
422Wniosek o zatwierdzenie nie powiódł się
Przygotowanie interaktywnego formularza testowego...