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

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

تحديثات CMS الفورية هي نقطة نهاية POST موقعة واختيارية تُخبر geodeck بتحديث llms.txt ونسخ الصفحات النظيفة وإدخالات sitemap وتنبيهات البحث ذات الصلة خلال دقائق من تغيير المحتوى، بدلاً من انتظار فرق sitemap اليومي التالي. اعتبارًا من 2026 تقبل نقطة النهاية أيضًا دفعات تصل إلى 500 عنوان URL لنفس المضيف في كل طلب موقّع. إذا لم تستخدمها، تبقى ملفاتك المستضافة وعمليات التدقيق مفيدة أيضًا، لكن ضمن الدورة اليومية الأبطأ.

نقطة النهاية

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 دقائق). بعد الفشل الثالث، أظهر الخطأ في سجل نظام إدارة المحتوى.

كيف تُقارن هذه الآلية بمعياري IndexNow وGoogle؟

حد الدفعة الخاص بـgeodeck أصغر من النظام الأوسع: تسمح وثائق IndexNow بدفعات أكبر بكثير في كل طلب، وبمجرد استلام أحد محركات البحث لتنبيه ضمن بروتوكول IndexNow تتم مشاركته تلقائيًا مع بقية المحركات المشاركة. تؤكد وثائق ميزات الذكاء الاصطناعي الخاصة بـGoogle أنه لا يوجد webhook أو تنسيق ملف منفصل مطلوب لميزات الذكاء الاصطناعي من Google، وتغطي مساعدة خرائط الموقع في Search Console المسار غير الفوري المكافئ الذي تهدف نقطة النهاية هذه إلى اختصاره.

You can submit up to 10,000 URLs per post, mixing http and https URLs if needed.

— IndexNow documentation

Search engines adopting the IndexNow protocol agree that submitted URLs will be automatically shared with all other participating search engines.

— IndexNow documentation

A successful request will return an HTTP 200 response code; if you receive a different response, verify that you don't submit too often, that the key and URL are valid and resubmit the request.

— IndexNow documentation

ماذا يمكنني أن أقرأ أيضًا؟

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

Platform