geodeck
← Все доки

Мгновенные обновления 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.

Подпись

Вычислите HMAC-SHA256 raw тела запроса, используя секрет webhook домена. Отправьте в шестнадцатеричной кодировке с префиксом 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