geodeck
← Todos los docs

Actualizaciones instantáneas del CMS

Usa este endpoint POST firmado y opcional si quieres que geodeck actualice llms.txt, tu Markdown Mirror, las señales del sitemap y otras actualizaciones de búsqueda pocos minutos después de un cambio de contenido. Si no necesitas actualizaciones instantáneas, tus archivos SEO/GEO alojados y tus auditorías siguen siendo útiles.

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.
  • 401 Unauthorized – dominio desconocido o no registrado.
  • 402 Payment Required – cuota mensual de pings superada.

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.

¿Qué más puedo leer?

Sigue leyendo el resto de la documentación de geodeck o ve a las páginas de la plataforma.

Platform