geodeck
← Todos os docs

Webhook CMS

Notifique o geodeck na publicação/despublicação para acionar a regeneração de llms.txt e pings downstream.

Ponto de extremidade

POST https://geodeck.icu/api/webhook/cms
X-geodeck-Signature: sha256=<hex hmac of raw body>
Content-Type: application/json

Carga útil

{
  "domain": "example.com",
  "url":    "https://example.com/blog/post-slug",
  "event":  "publish"
}

event deve ser um de publish, update ou 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.

Assinatura

Calcule HMAC-SHA256 do corpo de pedido raw usando o segredo webhook do domínio. Envie codificado em hex com o prefixo sha256=.

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

Respostas

  • 202 Accepted - payload em fila.
  • 401 Unauthorized - assinatura em falta/inválida.
  • 404 - domínio desconhecido.
  • 429 - limite de taxa do plano atingido.

Repetição

Numa resposta 5xx nossa, tente novamente com backoff exponencial (1s, 5s, 30s, 5min). Após a terceira falha, apresente o erro no log do seu CMS.

What else can I read?

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

Platform