Endpointy
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | /account/crons.json |
Lista cronów konta |
| GET | /account/crons/:id.json |
Pojedynczy cron |
| POST | /account/crons.json |
Utworzenie crona |
| PATCH | /account/crons/:id.json |
Aktualizacja crona |
| DELETE | /account/crons/:id.json |
Usunięcie crona |
| POST | /account/crons/:id/run.json |
Ręczne uruchomienie (kolejkuje wykonanie w tle) |
Autoryzacja: Authorization: Bearer TOKEN. Token musi mieć uprawnienie crons (domyślnie admin/owner).
Pola crona
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
kind |
string | tak | Rodzaj akcji: voip_reports, helpdesk_reports, flow, app
|
schedule |
string | tak | Harmonogram w formacie cron, np. "0 3 * * *". Opcjonalnie ze strefą czasową: "0 3 * * * Europe/Warsaw"
|
target_code |
string | dla kind: flow / app
|
Cel akcji: dla flow kod przepływu (Connect::Flow), dla app kind aplikacji (np. "service/getresponse_ma_app") |
name |
string | nie | Własna nazwa crona (domyślnie wyświetlana jest nazwa akcji) |
active |
boolean | nie | Czy cron jest aktywny (domyślnie true) |
Pola tylko do odczytu w odpowiedzi: next_run_at (termin następnego uruchomienia), last_run_at, last_status ("ok" albo "error: ...").
Akcje systemowe (voip_reports, helpdesk_reports) mogą istnieć na koncie tylko raz. Cronów kind: flow / kind: app może być wiele, każdy z innym target_code.
Przykład - cron uruchamiający Flow co godzinę
POST /account/crons.json
Authorization: Bearer TOKEN
Content-Type: application/json
{
"cron": {
"kind": "flow",
"target_code": "moj_flow",
"schedule": "0 * * * *",
"active": true
}
}
Odpowiedź 201 Created zawiera utworzony rekord razem z wyliczonym next_run_at.
Przykład - ręczne uruchomienie
POST /account/crons/123/run.json
Authorization: Bearer TOKEN
Odpowiedź 200 OK. Wykonanie jest kolejkowane w tle, wynik pojawi się w last_run_at / last_status.