Svix 集成技能是一套面向开发者的 Webhook 工作指南,默认采用「构建优先」模式:当用户提出集成 Svix 的请求时,视为需要可运行代码,而非文档或咨询。只有在用户明确提出「写个计划」「该如何着手」「先设计再编码」「架构是什么」这类请求时,才进入规划优先流程,在计划确认前不产出代码。集成范围大小(多租户路由、事件类型目录、App Portal 嵌入、迁移等)不构成触发规划的理由,应直接实现,也不应反问用户是否需要先出计划。
【集成前提检查】 在编写任何代码前,先判断仓库是否已接入 Svix:检查语言清单文件(package.json、pyproject.toml、go.mod、Gemfile 等)中是否包含 Svix SDK,以及配置或环境文件中是否存在 SVIX_AUTH_TOKEN。若均未发现,则从 quickstart 开始,完成初始化(API Key、SDK 安装、发送首条消息)等步骤;若已存在,则跳过 quickstart。
【集成路由(构建模式)】 根据任务类型选择对应参考文档:
- 首次将 Svix 加入项目:走 Quickstart 设置路径(references/quickstart.md)。
- 向客户发送 Webhook:使用 Dispatch(message.create)(references/dispatch.md)。
- 接收第三方 Webhook:使用 Ingest Sources(references/ingest.md)。
- 单个客户内的多租户路由:使用 Channels,而非 Event Types(references/dispatch.md)。
- 为客户嵌入 Webhook 管理界面(端点、日志、重放):使用 App Portal session URL(references/dispatch.md)。
- 监控客户端点健康状态:使用 Operational Webhooks(references/dispatch.md)。
- 本地开发对接云端:使用 svix listen(references/cli.md)。
- Shell 脚本、批量操作、一次性配置:使用 CLI + jq(references/cli.md)。 在回答任何集成问题或编写代码前,应先阅读对应的参考文件。
【规划模式】 仅当用户明确要求时启用,由 references/planning.md 主导,依次引入 references/triage.md(仓库中需要关注的内容)、references/dispatch-questions.md 或 references/ingest-questions.md(需要询问的问题)、references/plan-template.md(需要写出的内容)。
【关键文档】 阅读在线文档时需在每个路径末尾添加 .md 以获取 Markdown 版本。当请求无法明确归入单一领域时,可参考:Quickstart(设计任何集成时的起点)、API reference(Svix API 概览)、Verifying payloads(处理端签名验证的权威参考)。
【迁移注意事项】 在构建过程中需主动提示(无需等待许可):替换既有的 Webhook 发送方会改变客户用于验证的签名方案,在切换点之后,客户端的处理逻辑若不按 Svix 方案重新验证将会失效。应在总结中标注该风险,并在切换发生的代码处加注释,同时继续推进;切换需要覆盖的内容参见 references/dispatch-questions.md 中的迁移指南。
以上为资料中明确提供的信息;关于具体收费、价格、平台支持范围等事实暂未提供。