SuperAPI AI 工具集

svix-sending-webhooks

编程与开发

查看项目

更新于 10-16 02:16

技能介绍

用途

该技能面向需要集成 Svix webhook 能力的开发任务。它根据用户的请求内容和仓库现状,路由到对应的参考文档,并默认以「构建」模式输出可运行代码。

主要能力

  • 首次接入:为项目首次接入 Svix,提供快速开始路径(quickstart.md)。
  • 向客户发送 webhook:使用 Dispatch(message.create),详见 dispatch.md。
  • 接收第三方 webhook:使用 Ingest Sources,详见 ingest.md。
  • 单一客户内的多租户路由:使用 Channels(而非 Event Types),详见 dispatch.md。
  • 嵌入式 webhook 管理:为端点、日志、重放提供 App Portal session URL,详见 dispatch.md。
  • 监控客户端点健康:通过 Operational webhooks,详见 dispatch.md。
  • 本地开发对接云端:使用 svix listen,详见 cli.md。
  • Shell 脚本、批量操作、一次性配置:结合 CLI + jq,详见 cli.md。

使用方式

  1. 首先检查 Svix 是否已接入仓库:在语言清单文件(package.json、pyproject.toml、go.mod、Gemfile 等)中查找 Svix SDK,并在配置或 env 文件中查找 SVIX_AUTH_TOKEN。
  2. 若尚未接入,从 quickstart.md 开始;若已接入,跳过 quickstart。
  3. 根据集成路由表读取相应参考文件,再编写代码。
  4. 安装:可通过 npx skills add svix/ai 永久安装,使参考文件在本地可用。

模式说明:

  • 默认「构建」模式,直接编写代码。集成 Svix 的请求即视为需要可运行代码的请求。
  • 仅当用户明确要求计划时才进入规划模式。
  • 规模大小(多租户路由、事件类型目录、App Portal 嵌入、迁移等)不构成进入规划模式的触发条件。

适用场景

需要向客户发送 webhook、接收第三方 webhook、在单一客户内做多租户路由、嵌入 webhook 管理界面、监控客户端点健康、本地开发调试或进行批量与脚本化操作的项目。

限制与注意事项

  • 替换现有 webhook 发送方会改变客户用于验证的签名,客户侧处理程序在切换时若不按 Svix 方案重新验证将中断。这一点需在总结中标注,并在发生切换的代码处注明;具体切换需覆盖的内容见 dispatch-questions.md 的迁移指引。
  • 阅读在线文档时,需在每个路径末尾加 .md 以获取 markdown 版本。
  • 当请求不明确归属于某一领域时,可参考 Quickstart、API reference、Verifying payloads 文档。
  • 关于收费、价格、平台支持等具体信息暂未提供。