geodeck
← Alle Docs

CMS-Webhook

Benachrichtige geodeck bei Publish/Unpublish, um llms.txt-Regenerierung und nachgelagerte Pings auszulösen.

Endpunkt

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

Nutzlast

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

event muss eines von publish, update oder unpublish sein.

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.

Signierung

Berechne HMAC-SHA256 des raw Request-Bodys mit dem Domain-Webhook-Secret. Sende hexadezimal-kodiert mit dem sha256=-Präfix.

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

Antworten

  • 202 Accepted - Payload in Warteschlange.
  • 401 Unauthorized - fehlende/ungültige Signatur.
  • 404 - unbekannte Domain.
  • 429 - Plan-Ratenlimit erreicht.

Wiederholung

Bei einer 5xx-Antwort von uns, mit exponentiellem Backoff wiederholen (1s, 5s, 30s, 5min). Nach dem dritten Fehler den Fehler in deinem CMS-Log anzeigen.

What else can I read?

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

Platform