stable · overview · 0.1.0

Jobs & Scheduling

排程 invocation，不執行任意程式碼

MiniCenter 保存排程、建立 durable invocation，並以已註冊 endpoint 與 secret 傳送 signed HTTPS request。Project Backend 保有業務實作；MiniCenter 不接受 source code、command、script 或每次排程覆寫 callback URL。

每個 invocation 都有穩定 ID。Project Backend 必須驗證簽章並以該 ID 去重，因為 worker lease recovery 與 retry 提供的是 at-least-once delivery。

一次性與 recurring

Schedule 可指定一次 run_at，或加入 60 秒至 31 天的 interval_seconds。Recurring schedule 只在目前 invocation 成功或進入 dead-letter 後建立下一次 invocation，避免無界預先展開。

立即執行的 asynchronous background work 使用一次性 schedule，將 run_at 設為目前或過去時間且省略 interval_seconds。這只表示 invocation 已可被 worker claim，不保證在特定秒數內開始；呼叫端應保存 invocation_id 並查詢 outcome。需要未來時間時用一次性 schedule，需要固定間隔時才用 recurring。

先閱讀建立排程與驗證 invocation，再了解failure、retry、quota 與 cancellation。

Guides

• 建立排程與驗證 invocation — 註冊 operation endpoint、建立 recurring schedule，並驗證 signed invocation。
• Failure、retry、quota 與 cancellation — 觀察 invocation lifecycle、retry、dead-letter、quota pause 與 schedule cancellation。

API Reference

• Register a scheduled operation endpoint — POST /api/v1/scheduled-operations
• Schedule a registered operation — POST /api/v1/invocation-schedules
• Get an invocation schedule and its runs — GET /api/v1/invocation-schedules/{scheduleId}
• Cancel an invocation schedule — DELETE /api/v1/invocation-schedules/{scheduleId}
• Get a scheduled invocation outcome — GET /api/v1/scheduled-invocations/{invocationId}

Event Reference

• Scheduled invocation — The signed invocation body delivered to a registered Project Backend endpoint.