跳转到主要内容

概览

Webhook 可以在每次转换完成时向你自己的接口发送一条 HTTP POST 通知。你可以用它触发 Zapier、Make、n8n 或任意自建后端的工作流。
Webhook 是 PRO 套餐功能。每个用户最多注册 3 个 webhook 端点

设置

  1. 打开 Web2MD 扩展,进入 Settings
  2. 滚动到 Webhooks 区域。
  3. 输入你的端点 URL,点击 Add Webhook
  4. 复制签名密钥(signing secret)——验证请求来源时会用到。

请求负载

转换完成时,Web2MD 会向你的端点发送一个 POST 请求,JSON 请求体如下:

安全

每个 webhook 请求都带有 X-Web2MD-Signature 头,内容是用你的 webhook 签名密钥对原始请求体做的 HMAC-SHA256 签名。
处理 webhook 前务必先验证签名,防止攻击者向你的端点伪造请求。

验证示例(Node.js)

比较签名时用 crypto.timingSafeEqual 而不是 ===,避免时序攻击。

重试策略

两次都失败(非 2xx 响应或超时)时,这次投递会被丢弃。除这一次重试外,Web2MD 不再继续重试。

使用场景

Zapier / Make / n8n

在自动化平台里用 Webhook 触发器,每当有页面被转换就启动一个工作流——发到 Slack、往表格加一行,或存进 Notion。

Slack 通知

团队成员每转换一个页面就往 Slack 频道发条消息,让所有人保持同步。

自动存到外部存储

通过 REST API(用 conversionId)取回完整 Markdown,存到 S3、Google Drive 或你自己的数据库。

分析管线

把 webhook 事件转发到你的分析后端,跟踪转换量和内容类型。

测试 webhook

开发阶段可以用 webhook.sitengrok 之类的工具暴露一个本地端点,先看看收到的负载长什么样,再把处理器部署到生产环境。