Sofortige CMS-Updates

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.

Wie verhält sich das im Vergleich zu den IndexNow- und Google-Standards?

geodecks eigene Batch-Obergrenze ist kleiner als im breiteren Ökosystem: Die IndexNow-Dokumentation erlaubt weitaus größere Batches pro Anfrage, und sobald eine Suchmaschine einen Ping unter dem IndexNow-Protokoll erhält, wird dieser automatisch mit jeder anderen teilnehmenden Suchmaschine geteilt. Googles Dokumentation zu KI-Funktionen bestätigt, dass für Googles KI-Funktionen kein separater Webhook oder Dateiformat erforderlich ist, und die Sitemap-Hilfe der Search Console deckt den entsprechenden nicht-sofortigen Weg ab, den dieser Endpunkt abkürzen soll.

Sie können pro Post bis zu 10.000 URLs übermitteln und dabei http- und https-URLs bei Bedarf mischen.

— IndexNow documentation

Suchmaschinen, die das IndexNow-Protokoll übernehmen, stimmen zu, dass übermittelte URLs automatisch mit allen anderen teilnehmenden Suchmaschinen geteilt werden.

— IndexNow documentation

Eine erfolgreiche Anfrage liefert den HTTP-200-Antwortcode zurück; erhalten Sie eine andere Antwort, prüfen Sie, ob Sie nicht zu häufig übermitteln, ob Schlüssel und URL gültig sind, und senden Sie die Anfrage erneut.

— IndexNow documentation