Actualizaciones instantáneas del CMS

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.

¿Cómo se compara esto con los estándares de IndexNow y Google?

El límite de lote propio de geodeck es menor que el del ecosistema más amplio: la documentación de IndexNow permite lotes mucho mayores por solicitud, y en cuanto un motor de búsqueda recibe un aviso bajo el protocolo IndexNow, este se comparte automáticamente con todos los demás motores participantes. La documentación de Google sobre funciones de IA confirma que no se requiere un webhook o formato de archivo independiente para las funciones de IA de Google, y su ayuda de sitemaps de Search Console cubre la vía equivalente no instantánea que este punto de conexión pretende acortar.

Puede enviar hasta 10.000 URL por solicitud, mezclando URL http y https si es necesario.

— IndexNow documentation

Los motores de búsqueda que adoptan el protocolo IndexNow acuerdan que las URL enviadas se compartirán automáticamente con todos los demás motores de búsqueda participantes.

— IndexNow documentation

Una solicitud correcta devolverá un código de respuesta HTTP 200; si recibe una respuesta diferente, compruebe que no está enviando solicitudes con demasiada frecuencia, que la clave y la URL son válidas, y vuelva a enviar la solicitud.

— IndexNow documentation