用途:该技能用于设计服务间集成方案,覆盖 Webhook 系统、事件驱动架构、API 链式组合、ETL 与事件管道等集成模式。
主要能力:
- Webhook 设计。出站 Webhook 使用 POST {subscriber_url},请求头包含 Content-Type、X-Webhook-Signature(hmac-sha256=<sig>)、X-Webhook-Event、X-Webhook-Delivery、X-Webhook-Timestamp;载荷信封含 event、delivery_id、created_at、data 字段。接收方使用 HMAC-SHA256 校验签名。入站注册 API 包括:POST /api/v1/webhooks(注册 URL 与事件)、GET /api/v1/webhooks(列出订阅)、DELETE /api/v1/webhooks/{id}(取消订阅)、POST /api/v1/webhooks/{id}/test(发送测试事件)、GET /api/v1/webhooks/{id}/deliveries(投递历史与状态)。
- API 链式调用:按步骤获取 token、读取用户资料、创建订单、发起支付,每步使用前一步结果;要求各步骤独立处理失败、使用幂等键、指数退避重试。
- 事件驱动架构:事件结构遵循 CloudEvents 规范,含 specversion、type、source、id、time、datacontenttype、data;并给出主题/队列的生产者、消费者与保留期设计示例。
- 分布式事务模式:编排式 Saga(订单创建、库存预留、支付、订单确认,失败时执行补偿事务);Outbox 模式通过事务内写 outbox_events 表并由独立发布者轮询投递,保证事件可靠发布。
- 集成检查清单:状态变更调用使用幂等键,指数退避重试(base 1s、max 60s、带 jitter),熔断器(10 秒内 5 次失败后打开),死信队列,Webhook 投递日志与手动重放,事件 schema 版本化,跨服务调用携带关联 ID。
使用方式:在用户提出 API 集成、Webhook 流程、事件管道或服务组合设计需求时使用;完成后会询问是否生成对应的 API 安全模式,若 api-security-patterns 技能可用则以此为输入继续。
限制:官方文本未提供具体安装命令、支持的平台与运行环境、收费信息或效果保证,暂未提供。分类依据其集成设计用途归入编程与开发。