geodeck
← Tous les docs

Mises à jour instantanées du CMS

Utilisez ce point de terminaison POST signé et optionnel si vous voulez que geodeck rafraîchisse llms.txt, votre Markdown Mirror, les signaux de sitemap et les autres mises à jour de recherche quelques minutes après un changement de contenu. Si vous n’avez pas besoin de mises à jour instantanées, vos fichiers SEO/GEO hébergés et vos audits restent utiles.

Point de terminaison

POST https://geodeck.icu/api/webhook/cms
X-geodeck-Signature: sha256=<hex hmac of raw body>
Content-Type: application/json

Charge utile

{
  "domain": "example.com",
  "url":    "https://example.com/blog/post-slug",
  "event":  "publish"
}

event doit être l'un 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.

Signature

Calculez HMAC-SHA256 du corps de requête raw en utilisant le secret webhook du domaine. Envoyez encodé en hex avec le préfixe sha256=.

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

Réponses

  • 202 Accepted – payload mis en file.
  • 401 Unauthorized – signature manquante/invalide.
  • 401 Unauthorized – domaine inconnu ou non enregistré.
  • 402 Payment Required – quota mensuel de pings dépassé.

Nouvelle tentative

Sur une réponse 5xx de notre part, réessayez avec un backoff exponentiel (1s, 5s, 30s, 5min). Après le troisième échec, affichez l'erreur dans le log de votre CMS.

Que puis-je lire d'autre ?

Continuez à lire la documentation geodeck ou accédez aux pages de la plateforme.

Platform