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

Подпись

Вычислите 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.

Как это соотносится со стандартами IndexNow и Google?

Собственный лимит пакета geodeck меньше, чем в более широкой экосистеме: документация IndexNow допускает гораздо большие пакеты на запрос, а как только поисковая система получает уведомление по протоколу IndexNow, оно автоматически передаётся всем остальным участвующим системам. Документация Google о функциях AI подтверждает, что для функций AI Google не требуется отдельный webhook или формат файла, а справка Search Console по sitemap описывает эквивалентный неинстантный путь, который этот endpoint призван сократить.

You can submit up to 10,000 URLs per post, mixing http and https URLs if needed.

— IndexNow documentation

Search engines adopting the IndexNow protocol agree that submitted URLs will be automatically shared with all other participating search engines.

— IndexNow documentation

A successful request will return an HTTP 200 response code; if you receive a different response, verify that you don't submit too often, that the key and URL are valid and resubmit the request.

— IndexNow documentation