跳到主要内容

外部集成任务模板

适用场景:第三方 API、Webhook、异步任务、队列消费或后台 job。

任务:实现或调整一个外部服务集成
集成对象:
鉴权方式:
超时与重试策略:
幂等键或去重规则:
失败分类:
告警与观测要求:
允许修改的层:
- adapter / client
- queue consumer / job runner
- config / env manifest
- integration tests
禁止直接做的事:
- 在业务代码里散落 SDK 调用
- 省略 timeout / retry / dead-letter 规则
- 缺少 sandbox 或 fake 测试路径

最少补哪几类证据

  • sandbox 或 fake 测试路径
  • timeout / retry / dead-letter 说明
  • 失败分类与告警条件
  • 回滚或人工接管入口

配套页面