用途:Ghost Webhooks 通过事件驱动的 HTTP POST 请求实现集成,配合 Content API 与 Admin API SDK,可用于自定义集成、静态站点重建触发、通知系统与内容自动化管线。
主要能力:Ghost 支持 31 个 Webhook 事件,分为站点(site.changed)、文章(post.added/edited/published/unpublished/scheduled 等 10 个)、页面(page.* 10 个)、标签(tag.* 及 post/page.tag.attached/detached 共 7 个)、成员(member.added/edited/deleted 3 个)五类。Payload 为 JSON,current 含资源完整状态,previous 仅含变更字段;返回 2xx 视为成功,响应体被丢弃。
使用方式:可在 Ghost Admin > Settings > Integrations > Custom Integration 添加 Webhook;也可用 Admin API SDK(@tryghost/admin-api)的 webhooks.add/edit/delete,或 cURL 调用 /ghost/api/admin/webhooks/。接收端示例用 Express 监听 POST 并处理 post、member 等字段。Content API SDK(@tryghost/content-api)提供只读内容访问,Admin API SDK 提供读写(仅服务端)。
适用场景:静态站点重建(Netlify/Vercel)、Slack 发布通知、成员同步 CRM、无头 CMS(Next.js、Gatsby、Eleventy、Nuxt、Gridsome、VuePress、Hexo、Hugo)、内容迁移(支持 BeeHiiv、Substack、WordPress、Medium 等来源)。
限制:Webhook 无 Browse 端点,无法通过 API 列出;官方未记录各事件的确切 payload schema;无文档化的重试逻辑(重试次数、退避、超时均未说明);secret 字段存在但签名验证机制未公开(无 HMAC 算法、头名称或验证流程)。集成权限固定有限,完整 API 访问需 Staff Access Token 或用户认证。API 用 Accept-Version: v5.0 指定版本,?limit=all 在 Ghost 6.0 已移除(每页最多 100)。