geodeck
← 所有文档

CMS 即时更新

CMS 即时更新是一个可选的签名 POST endpoint，它会告诉 geodeck 在内容变更后几分钟内刷新 llms.txt、清洁页面副本、sitemap 条目以及相关搜索 ping，而不用等待下一次每日 sitemap diff。自 2026 年起，该 endpoint 每次签名请求还可接受最多 500 个同主机 URL 的批量提交。如果你跳过它，托管的文件和审计仍然有用，只是刷新周期会慢一些，走每日循环。

端点

POST https://geodeck.icu/api/webhook/cms
X-geodeck-Signature: sha256=<hex hmac of raw body>
Content-Type: application/json

有效载荷

{
  "domain": "example.com",
  "url":    "https://example.com/blog/post-slug",
  "event":  "publish"
}

event必须是publish、update或unpublish之一。

Batch submission

{
  "domain": "example.com",
  "urls": [
    "https://example.com/blog/post-one",
    "https://example.com/blog/post-two"
  ],
  "event": "update"
}

Batch mode accepts up to 500 same-host URLs per signed request. In batch mode, omit title, summary, content, and html.

签名

使用域名的Webhook密钥计算请求正文raw的HMAC-SHA256。使用sha256=前缀十六进制编码发送。

echo -n "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex

响应

  • 202 Accepted - 有效载荷已排队。
  • 401 Unauthorized - 签名缺失/无效。
  • 401 Unauthorized - 未知域名。
  • 402 Payment Required - 计划速率限制已达到。

重试

收到5xx响应时，使用指数退避重试（1秒、5秒、30秒、5分钟）。第三次失败后，在CMS日志中显示错误。

这与 IndexNow 和 Google 的标准相比如何？

geodeck 自身的批量上限比更广泛的生态系统要小：IndexNow 文档允许每次请求提交大得多的批量，而且在IndexNow 协议下，一个搜索引擎收到 ping 后，会自动与所有其他参与的搜索引擎共享。Google 的AI 功能文档确认 Google 的 AI 功能不需要单独的 webhook 或文件格式，其Search Console sitemap 帮助文档涵盖了这个 endpoint 想要缩短的、非即时的等效路径。

你可以在一次提交中提交最多 10,000 个 URL，如有需要可以混用 http 和 https URL。

— IndexNow documentation

采用 IndexNow 协议的搜索引擎同意，提交的 URL 会自动与所有其他参与的搜索引擎共享。

— IndexNow documentation

成功的请求会返回 HTTP 200 响应代码；如果你收到了不同的响应，请确认你没有提交得过于频繁、密钥和 URL 是否有效，然后重新提交请求。

— IndexNow documentation

还可以阅读什么？

继续阅读 geodeck 文档，或前往平台页面。

Platform