geodeck
← Alle Docs

Sofortige CMS-Updates

Nutze diesen optionalen signierten POST-Endpunkt, wenn geodeck llms.txt, deinen Markdown Mirror, Sitemap-Signale und verwandte Such-Updates innerhalb weniger Minuten nach einer Inhaltsänderung aktualisieren soll. Wenn du keine Sofort-Updates brauchst, bleiben deine gehosteten SEO-/GEO-Dateien und Audits trotzdem nützlich.

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.
  • 401 Unauthorized – Domain unbekannt oder nicht registriert.
  • 402 Payment Required – Monatliches Ping-Kontingent erschöpft.

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.

Was kann ich sonst noch lesen?

Lies weiter in der geodeck-Dokumentation oder springe zu den Plattformseiten.

Platform