工作机会 (功能) | Inbox Manager API 文档

职位

作业功能定义了从任务和提供者事件派生的可执行队列单元。当异步工作失败时，它使您可以直接操作控制重试、手动触发和解决方案。

为什么这很重要

此功能使得队列执行可以按作业粒度进行观察，因此可以诊断和恢复故障，而无需猜测。它通过显式重试、触发和解析操作支持确定性运算符恢复，同时保持清理操作的深思熟虑和范围。

核心流程

任务或提供者事件生成工作人员执行的作业，并用状态、尝试和失败详细信息进行注释。操作员在帐户队列视图中查看失败或停滞的作业，运行显式重试/解决/触发操作，并使用生成的作业状态来跟踪任务生命周期和审核跟踪。

操作

运营	端点	目的
职位列表	`GET /api/accounts/:account_id/jobs`	获取帐户作业队列
搜索职位	`POST /api/accounts/:account_id/jobs/search`	按过滤器查询职位
通过搜索删除职位	`POST /api/accounts/:account_id/jobs/search-delete`	批量删除匹配的职位
找工作	`GET /api/jobs/:job_id`	检索一份工作
更新职位	`PATCH /api/jobs/:job_id`	修改可变的工作字段
删除职位	`DELETE /api/jobs/:job_id`	删除一项工作
重试作业	`POST /api/jobs/:job_id/retry`	重新排队失败的作业
解决工作	`POST /api/jobs/:job_id/resolve`	标记终端处理状态
触发作业	`POST /api/jobs/:job_id/trigger`	强制执行触发器

关键数据和状态

{
  id: "job_...",
  account_id: "acc_...",
  task_id: "tsk_...",
  action: "imap_sync_messages",
  attempt_count: 2,
  last_error_code: "provider_timeout",
  last_error_detail: "IMAP connection timed out"
}

故障模式和控制

失败的执行会保留明确的错误详细信息，以便进行确定性处理。重试、触发和解析是命令式操作，而不是隐式读取副作用，并且帐户范围的列表/搜索边界可防止跨帐户队列可见性。

职位

为什么这很重要

核心流程

操作

关键数据和状态

故障模式和控制

相关