Atualizações instantâneas do CMS

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.

Como é que isto se compara aos padrões IndexNow e Google?

O limite de lote do próprio geodeck é menor do que o do ecossistema mais amplo: a documentação do IndexNow permite lotes bem maiores por pedido, e assim que um motor de pesquisa recebe um aviso ao abrigo do protocolo IndexNow, este é partilhado automaticamente com todos os outros motores participantes. A documentação de funcionalidades de IA da Google confirma que não existe nenhum webhook ou formato de ficheiro separado exigido para as funcionalidades de IA da Google, e a sua ajuda de sitemaps da Search Console cobre o caminho não instantâneo equivalente que este endpoint pretende encurtar.

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