geodeck
← 所有文档

CMS 即时更新

如果你希望 geodeck 在内容变更后几分钟内刷新 llms.txt、Markdown Mirror、sitemap 信号以及相关搜索更新，就使用这个可选的签名 POST endpoint。即使你不需要即时更新，你托管的 SEO / GEO 文件和审计仍然有价值。

端点

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日志中显示错误。

还可以阅读什么？

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

Platform