用途:处理从“我想连接 X”到任务真正运行之间的事务,包括选 provider 与 workflow、字段映射、创建 auth 与连接、webhook 模板、任务生命周期管理,以及排查某用户为何进入或未进入目的地。集成分层为 Provider(平台)→ Auth(鉴权)→ Connection(可选,数据源集成)→ Job(运行一个 workflow)。
主要能力与模式:advise 用于选型与规划映射;setup 按依赖顺序端到端创建 auth→connection→job;connections 管理连接与 auth provider、读取 schema;jobs 管理任务创建、更新、暂停/恢复/反弹/终止/释放及日志;webhook-templates 面向自定义 webhook 目的地;export-debug 只读排查导出问题。明确请求可直接进入 setup 或 jobs。
使用方式:先阅读 references/auth.md 了解凭据、references/api.md 了解请求约定与 /v2 错误结构(.errors[0].message);所有创建、更新、删除与生命周期命令需经过 references/confirmation-gate.md。不要记录或显示完整凭据值。OAuth 无法在 CLI 完成,需让用户在 Lytics UI 操作,再通过 GET /v2/auth 获取新 auth_id。
限制与注意事项:POST /v2/job 与 /v2/job/{workflow} 默认 run_job 为 true,创建即开始发送数据,可传 ?run_job=false 仅创建;任务更新是整体替换而非合并,需先 GET 再改后 PUT 整个对象;kill 为软删除且无法撤销,可改用 pause;状态值不含 runnable、fault、killed,需按 fault 前缀匹配;被 kill 的任务默认隐藏,需 show_all=true,/v2/job/logs 也不含;GET /v2/job/{id} 不返回 sleep_until,需用 GET /v2/job?show_state=true;quiet window 为 drop 而非排队;webhook 模板更新用 PUT /v2/template/{id},模板源码不可读回;webhook 任务配置无 headers 字段,头部由 header_param_auth 提供。价格、平台支持范围等资料暂未提供。