CMSウェブフック

エンドポイント

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 - 署名が不足/無効です。
• 404 - 不明なドメインです。
• 429 - プランのレート制限に達しました。

リトライ

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