← جميع المستندات

تحديثات CMS الفورية

استخدم نقطة POST الموقعة والاختيارية هذه إذا أردت أن يحدّث geodeck ملف llms.txt وMarkdown Mirror وإشارات sitemap وغيرها من تحديثات البحث خلال دقائق من تغيير المحتوى. وإذا لم تحتج إلى تحديثات فورية، فستبقى ملفات SEO/GEO المستضافة وعمليات التدقيق مفيدة أيضًا.

نقطة النهاية

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

الحمولة

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

يجب أن يكون event أحد publish أو update أو 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.

التوقيع

احسب HMAC-SHA256 لجسم الطلب raw باستخدام مفتاح webhook السري للنطاق. أرسل مُشفَّراً بـhex مع بادئة sha256=.

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

الاستجابات

  • 202 Accepted – الحمولة في قائمة الانتظار.
  • 401 Unauthorized – توقيع مفقود/غير صالح.
  • 401 Unauthorized – نطاق غير معروف.
  • 402 Payment Required – تم الوصول إلى حد معدل الخطة.

إعادة المحاولة

عند استجابة 5xx، أعِد المحاولة بتراجع أسي (1ث، 5ث، 30ث، 5 دقائق). بعد الفشل الثالث، أظهر الخطأ في سجل نظام إدارة المحتوى.

تابع قراءة بقية وثائق geodeck أو انتقل إلى صفحات المنصة.

Platform