geodeck
← Todos los docs

Webhook CMS

Notifica a geodeck en publicación/despublicación para activar la regeneración de llms.txt y pings downstream.

Punto final

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 debe ser uno de publish, update o 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.

Firma

Calcula HMAC-SHA256 del cuerpo de solicitud raw usando el secreto webhook del dominio. Envía codificado en hex con el prefijo sha256=.

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

Respuestas

  • 202 Accepted - payload en cola.
  • 401 Unauthorized - firma faltante/inválida.
  • 404 - dominio desconocido.
  • 429 - límite de tasa del plan alcanzado.

Reintento

Ante una respuesta 5xx nuestra, reintenta con backoff exponencial (1s, 5s, 30s, 5min). Tras el tercer fallo, muestra el error en el log de tu CMS.

What else can I read?

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

Platform