geodeck
← Todos os docs

Atualizações instantâneas do CMS

Use este endpoint POST assinado e opcional se quiser que o geodeck atualize llms.txt, o seu Markdown Mirror, sinais de sitemap e outras atualizações de pesquisa poucos minutos após uma alteração de conteúdo. Se não precisar de atualizações instantâneas, os seus ficheiros SEO/GEO alojados e auditorias continuam úteis.

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.
  • 401 Unauthorized – domínio desconhecido ou não registado.
  • 402 Payment Required – quota mensal de pings esgotada.

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.

O que mais posso ler?

Continue lendo o restante da documentação do geodeck ou acesse as páginas da plataforma.

Platform