CMS 即時更新

この任意の署名付き POST endpoint を使うと、コンテンツ変更の数分後に geodeck が llms.txt、Markdown Mirror、sitemap シグナル、関連する検索更新を反映します。即時更新が不要でも、ホストされた 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.

署名

ドメインのウェブフックシークレットを使用してリクエストボディのrawのHMAC-SHA256を計算します。sha256=プレフィックスを付けて16進数エンコードで送信します。

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

レスポンス

202 Accepted – ペイロードをキューに入れました。
401 Unauthorized – 署名が不足/無効です。
401 Unauthorized – 不明なドメインです。
402 Payment Required – プランのレート制限に達しました。

リトライ

5xxレスポンスの場合、指数バックオフ（1秒、5秒、30秒、5分）で再試行してください。3回目の失敗後はCMSログにエラーを表示してください。

geodeckドキュメントの続きを読むか、プラットフォームページへ移動してください。