1. 内置 IndexNow 密钥验证接口说明
SISEO 门户内置了符合 IndexNow 官方规范的密钥验证端点 `/api/indexnow/key`，并通过 `next.config.ts` 的 `rewrites` 规则映射到根路径 `/:key([a-f0-9]{8,128}).txt`：
| 请求路径 | HTTP 方法 | 响应 Content-Type | 状态码说明 |
|---|---|---|---|
| /{INDEXNOW_KEY}.txt | GET / HEAD | text/plain; charset=utf-8 | 密钥匹配时返回 200 OK 与纯文本密钥；不匹配时返回 404 Not Found |
| /api/indexnow/key?key={key} | GET | text/plain; charset=utf-8 | 底层处理路由，自动附带 Cache-Control: public, max-age=86400 |
2. 站点健康度与爬虫异常 Webhook 载荷格式
当您在业务控制台（`seomatrix.pro`）配置了告警 Webhook 地址后，一旦检测到真实搜索引擎蜘蛛访问返回 5xx 错误、核心页面 Canonical 丢失或 Sitemap 存活率跌破阈值，系统将使用 `HMAC-SHA256` 签名向您的接收端推送如下 JSON 事件：
webhook-event-example.jsonjson
{
"event_id": "evt_20261020_9f8a7b6c",
"event_type": "crawler.http_5xx_spike",
"severity": "critical",
"occurred_at": "2026-10-20T05:15:00Z",
"site": {
"domain": "www.siseo.cn",
"environment": "production"
},
"crawler": {
"engine": "Baiduspider",
"rdns_verified": true,
"sample_hostname": "baiduspider-220-181-108-95.crawl.baidu.com"
},
"metrics": {
"window_minutes": 5,
"total_requests": 420,
"error_5xx_count": 19,
"error_rate": 0.0452,
"affected_paths": ["/blog/baiduspider-log-analysis-rdns-guide"]
},
"console_url": "https://www.seomatrix.pro/spider-service?utm_source=siseo.cn&utm_medium=webhook"
}3. Webhook 接收端签名安全校验
为防止第三方伪造告警请求，所有 Webhook 请求均携带 `X-SISEO-Signature` 与 `X-SISEO-Timestamp` 请求头。接收服务应校验时间戳偏差不超过 300 秒，并使用控制台分发的 `WEBHOOK_SECRET` 计算请求体 HMAC-SHA256 摘要进行恒定时间比对（`crypto.timingSafeEqual`）。