SuperAPI AI 工具集

notion-webhooks

测试与质量

查看项目

更新于 10-15 22:14

技能介绍

用途:为 Notion 内部集成搭建 Webhook 处理程序,订阅并处理页面、评论、数据库与数据源事件,同时完成签名校验与订阅激活。

主要能力:Notion 使用 HMAC-SHA256 对原始请求体签名,签名密钥为集成的 verification_token,签名放在 X-Notion-Signature 头,格式为 sha256=<hex_digest>。新订阅的首次 POST 是握手请求,JSON 体含 verification_token 且无签名;处理程序需捕获该 token 并展示,再由开发者粘贴到 Notion 集成界面激活订阅,后续请求才带签名。技能提供 JavaScript 与 Python(FastAPI)的校验函数与 Express 处理程序示例,并列出常见事件类型:page.content_updated、page.properties_updated、page.created、page.deleted、page.locked、page.moved、comment.created、data_source.schema_updated(2025-09-03+),以及已弃用的 database.schema_updated(2022-06-28 之后弃用)。

使用方式:Express 需使用 express.raw({ type: 'application/json' }) 保留原始体;环境变量 NOTION_VERIFICATION_TOKEN 存握手阶段捕获的 token(非集成 API token)。本地开发可用隧道:npx hookdeck-cli listen 3000 notion --path /webhooks/notion,把 Hookdeck 打印的公网地址填入 Notion 集成界面;Notion 不支持 localhost。示例目录含 examples/express/、examples/nextjs/、examples/fastapi/。建议配合 webhook-handler-patterns 技能处理顺序、幂等、错误与重试。

限制:资料未提供收费、价格、性能或效果数据;正式接入细节以 Notion 官方文档为准。