geodeck
← Все доки

Webhook CMS

Уведомляйте geodeck при публикации/отмене публикации для запуска регенерации llms.txt и нижестоящих пингов.

Конечная точка

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.

Подпись

Вычислите HMAC-SHA256 raw тела запроса, используя секрет webhook домена. Отправьте в шестнадцатеричной кодировке с префиксом sha256=.

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

Ответы

  • 202 Accepted - полезная нагрузка поставлена в очередь.
  • 401 Unauthorized - подпись отсутствует/неверна.
  • 404 - неизвестный домен.
  • 429 - достигнут лимит скорости плана.

Повтор

При ответе 5xx от нас повторяйте с экспоненциальной задержкой (1 с, 5 с, 30 с, 5 мин). После третьего сбоя выведите ошибку в журнале CMS.

What else can I read?

Keep reading the rest of the Geodeck documentation, or jump to the platform pages.

Platform