SuperAPI AI 工具集

api-integration

编程与开发

查看项目

更新于 10-16 03:40

技能介绍

用途:当任务涉及 Webhook、事件流、API 组合、连接两个及以上 API、构建管道、Pub/Sub、Kafka 主题或 ETL 时使用,用于设计集成模式、Webhook 流程、事件管道与 API 组合策略。

主要能力:

  1. Webhook 设计。出站 Webhook 使用 POST {subscriber_url},头部含 Content-Type、X-Webhook-Signature(sha256=<sig>)、X-Webhook-Event、X-Webhook-Delivery、X-Webhook-Timestamp;载荷信封含 event、delivery_id、created_at、data。接收方用 HMAC-SHA256 校验签名,示例使用 hmac.compare_digest,并注明不要用 assert 作为授权边界。入站注册 API 提供注册、列出、删除订阅,以及测试事件与投递历史查询。
  2. API 链式调用。示例流程为获取 token、读取用户资料、创建订单、发起支付,要求每步独立处理失败、使用幂等键、指数退避重试。
  3. 事件驱动架构。事件模式采用 CloudEvents 规范;给出主题/队列的生产者、消费者与保留期设计示例;Saga 编排式分布式事务示例(下单、库存预留、支付、确认,失败时补偿回滚);Outbox 模式通过事务性 outbox 表与独立发布者保证可靠发布。
  4. 集成检查清单:状态变更调用加幂等键、指数退避重试(基数 1s、上限 60s、带抖动)、熔断(10 秒内 5 次失败后打开)、死信队列、Webhook 投递日志与手动重放端点、事件模式版本化、跨服务关联 ID。

使用方式与限制:仅在任务与上游来源及本地项目上下文明确匹配时使用;应用变更前需验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代环境相关测试、安全审查或对破坏性/高成本操作的用户批准。签名校验还需提供方当前协议、有界输入、时间戳/重放保护与授权测试端点。设计本身不构成集成或支付已运行的证据。其他细节暂未提供。