geodeck
← Tous les docs

Webhook CMS

Notifiez geodeck à la publication/dépublication pour déclencher la régénération de llms.txt et les pings downstream.

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.
  • 404 - domaine inconnu.
  • 429 - limite de taux du plan atteinte.

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.

What else can I read?

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

Platform