2FinanceDocs
Guias

Agendas e fuso horário

Normalize presets, linguagem natural e cron com políticas explícitas de DST e misfire.

Use preview antes de persistir

POST /v1/automations/schedule:preview devolve o trigger normalizado, uma descrição, o próximo horário e requires_confirmation: true.

Entradas suportadas

O código reconhece presets como daily_9, daily_18, weekdays_9 e monthly_1_9, algumas expressões equivalentes em português e cron avançado com cinco campos.

Fuso e DST

O fuso é validado pela base IANA. A normalização atual define:

  • dst_nonexistent: next_valid;
  • dst_repeated: once_earliest.

Assim, um horário pulado pelo avanço de relógio é coalescido no primeiro instante válido, enquanto uma hora repetida executa apenas na primeira ocorrência local.

Misfire

fire_once coalesce vencimentos recentes, skip ignora atrasos relevantes e catch_up_limited limita o número de recuperações. Vencimentos com mais de 24 horas são registrados como skipped.

Nesta página

Ver OpenAPI