概览
Webhook 可以在每次转换完成时向你自己的接口发送一条 HTTP POST 通知。你可以用它触发 Zapier、Make、n8n 或任意自建后端的工作流。Webhook 是 PRO 套餐功能。每个用户最多注册 3 个 webhook 端点。
设置
- 打开 Web2MD 扩展,进入 Settings。
- 滚动到 Webhooks 区域。
- 输入你的端点 URL,点击 Add Webhook。
- 复制签名密钥(signing secret)——验证请求来源时会用到。
请求负载
转换完成时,Web2MD 会向你的端点发送一个POST 请求,JSON 请求体如下:
安全
每个 webhook 请求都带有X-Web2MD-Signature 头,内容是用你的 webhook 签名密钥对原始请求体做的 HMAC-SHA256 签名。
验证示例(Node.js)
重试策略
两次都失败(非 2xx 响应或超时)时,这次投递会被丢弃。除这一次重试外,Web2MD 不再继续重试。
使用场景
Zapier / Make / n8n
在自动化平台里用 Webhook 触发器,每当有页面被转换就启动一个工作流——发到 Slack、往表格加一行,或存进 Notion。
Slack 通知
团队成员每转换一个页面就往 Slack 频道发条消息,让所有人保持同步。
自动存到外部存储
通过 REST API(用
conversionId)取回完整 Markdown,存到 S3、Google Drive 或你自己的数据库。分析管线
把 webhook 事件转发到你的分析后端,跟踪转换量和内容类型。