WordPress Webhook API

WordPress webhook 接口，用于接收 WordPress 的文章变更通知并自动清除对应的页面缓存。

鉴权

所有 webhook 请求需要通过 x-wp-webhook-source 头部进行鉴权，该头部值必须为 http://wordpress.classup.info/。

接口说明

POST /api/webhooks/wp/post_create

功能：处理 WordPress 文章创建事件

触发时机：当 WordPress 创建新文章时

处理逻辑：

• 验证文章分类是否为博客分类（category_id = 21）
• 清除所有语言版本的博客列表页缓存

请求示例：

{
  "post_id": 123,
  "categories": [21]
}

响应示例：

{
  "ok": true,
  "action": "post_create",
  "post_id": 123,
  "cleared": 8
}

POST /api/webhooks/wp/post_update

功能：处理 WordPress 文章更新事件

触发时机：当 WordPress 更新文章时

处理逻辑：

• 验证文章分类是否为博客分类（category_id = 21）
• 清除对应文章的所有语言版本的详情页缓存

请求示例：

{
  "post_id": 123,
  "categories": [21],
  "post": {
    "post_name": "article-slug"
  }
}

响应示例：

{
  "ok": true,
  "action": "post_update",
  "post_id": 123,
  "slug": "article-slug",
  "cleared": 8
}

POST /api/webhooks/wp/post_delete

功能：处理 WordPress 文章删除事件

触发时机：当 WordPress 删除文章或移动到回收站时（包括 post_delete 和 post_trash 两种场景）

处理逻辑：

• 验证文章分类是否为博客分类（category_id = 21）
• 清除对应文章的所有语言版本的详情页缓存
• 清除所有语言版本的博客列表页缓存

请求示例：

{
  "post_id": 123,
  "categories": [21],
  "post": {
    "post_name": "article-slug"
  }
}

响应示例：

{
  "ok": true,
  "action": "post_delete",
  "post_id": 123,
  "slug": "article-slug",
  "cleared": {
    "post": 8,
    "list": 8,
    "total": 16
  }
}

错误响应

所有接口在发生错误时会返回以下格式：

{
  "ok": false,
  "error": "错误信息"
}

常见错误：

• 401 Unauthorized：鉴权失败
• 400 Bad Request：请求参数无效（如 post_id 无效、分类不正确、slug 缺失等）
• 500 Internal Server Error：服务器内部错误