Mises à jour instantanées du CMS

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.

Comment cela se compare-t-il aux standards IndexNow et Google ?

Le plafond de lot propre à geodeck est plus restreint que celui de l'écosystème élargi : la documentation IndexNow autorise des lots bien plus importants par requête, et dès qu'un moteur de recherche reçoit une notification via le protocole IndexNow, celle-ci est automatiquement partagée avec tous les autres moteurs participants. La documentation de Google sur les fonctionnalités IA confirme qu'aucun webhook ni format de fichier distinct n'est requis pour les fonctionnalités IA de Google, et son aide sur les sitemaps de Search Console couvre le chemin non instantané équivalent que ce point de terminaison est censé raccourcir.

Vous pouvez soumettre jusqu'à 10 000 URL par requête, en mélangeant des URL http et https si nécessaire.

— IndexNow documentation

Les moteurs de recherche adoptant le protocole IndexNow conviennent que les URL soumises seront automatiquement partagées avec tous les autres moteurs de recherche participants.

— IndexNow documentation

Une requête réussie renverra un code de réponse HTTP 200 ; si vous recevez une réponse différente, vérifiez que vous ne soumettez pas trop fréquemment, que la clé et l'URL sont valides, puis renvoyez la requête.

— IndexNow documentation