هذه الصفحة مرجع الحقول لصفحة الروابط والواجهة في لوحة معلومات التاجر، وهي ما يفتحه زر مساعدة أعلى الصفحة في تبويب جديد. لخطوات العمل اليومي راجع الروابط والواجهة.
الغرض من الشاشة: تدير هذه الصفحة اشتراكات خطافات الويب: نقاط النهاية التي تستقبل أحداث المنشأة موقّعة ودائمة مع إعادة محاولة، ونسخة الحمولة المثبَّتة لكل منها. نظرة عامة هي تقرير نقاط النهاية، والإدارة هي محرّر نقطة نهاية واحدة مع سجل تسليماتها وإعادة الإرسال. تُعاد قراءة القائمة كل ١٥ ثانية.
رأس الصفحة والتنبيهات
| الحقل | المعنى |
|---|
| إضافة نقطة نهاية | الإجراء الرئيسي: يفتح نافذة «اشتراك جديد». يُفتح أيضًا من لوحة الأوامر. |
|---|
| وضع الصفحة | مفتاح بين «نظرة عامة» (البطاقات وجدول نقاط النهاية) و«الإدارة» (محرّر نقطة النهاية المختارة). الوضع محفوظ في عنوان الصفحة. |
|---|
| أوقف الخادم التسليم | ملاحظة تحذيرية تظهر أعلى الصفحة عندما تكون نقطة نهاية واحدة أو أكثر بحالة «معطّل»، أي أوقفها الخادم بعد سلسلة إخفاقات متتالية دون أي تسليم مقبول. أصلح النقطة ثم اضغط استئناف: التسليمات المعلّقة محفوظة وتُرسل من جديد ويُصفَّر عدّاد الإخفاقات. |
|---|
| سر التوقيع — يظهر مرة واحدة فقط | بطاقة تظهر مباشرة بعد إنشاء اشتراك أو تدوير سرّه، وتعرض «معرّف المفتاح» و«السر». انسخ السر الآن؛ لن يُعرض مرة أخرى، وإذا ضاع فدوّر السر لإصدار سر جديد. |
|---|
بطاقات النظرة العامة
| الحقل | المعنى |
|---|
| نقاط النهاية | عدد اشتراكات خطافات الويب في المنشأة، وتحته عدد النشطة منها. |
|---|
| موقوفة | عدد النقاط الموقوفة مؤقتًا بيدك؛ تتجمّع أحداثها ولا تُسلَّم حتى الاستئناف. لا تُحسب هنا النقاط التي أوقفها الخادم. |
|---|
| الإخفاقات | مجموع الإخفاقات المتتالية الحالية عبر كل النقاط. يتلوّن بالأحمر عندما يكون أكبر من صفر. لا يوجد عدّاد لآخر ٢٤ ساعة؛ انظر البطاقة الجانبية. |
|---|
| نسخة الحمولة | كل إصدارات المخطط الرئيسية المثبَّتة على أي نقطة نهاية، تصاعديًا مثل «v1 · v2». شرطة مع «لا تثبيت» عندما لا توجد اشتراكات مثبَّتة. |
|---|
جدول نقاط النهاية
| الحقل | المعنى |
|---|
| النقطة | اسم الاشتراك كرابط يفتحه في وضع الإدارة، وتحته عنوان HTTPS الذي تُسلَّم إليه الأحداث. |
|---|
| الأحداث | أسماء الأحداث المشترك فيها مفصولة بنقاط، مثل order.paid و inventory.changed. |
|---|
| آخر تسليم | تاريخ ووقت آخر تسليم قبلته هذه النقطة. «لم يُسلَّم بعد» عندما لم يُقبل أي تسليم. |
|---|
| الإخفاقات | عدد الإخفاقات المتتالية الحالية لهذه النقطة؛ يُصفَّر عند أول تسليم مقبول أو عند الاستئناف. بالأحمر عندما يكون أكبر من صفر. |
|---|
| الحالة | نشط: تُسلَّم الأحداث. موقوف: أوقفته أنت وتتجمّع أحداثه. معطّل: أوقفه الخادم بعد سلسلة إخفاقات، ويعود بالاستئناف بعد إصلاح النقطة. |
|---|
ضمانات التسليم
| الحقل | المعنى |
|---|
| ترويسة التوقيع | اسم ترويسة HTTP التي تحمل توقيع كل تسليم: Aidi-Webhook-Signature. يتحقق طرفك منها بسرّ الاشتراك. |
|---|
| سياسة الإعادة | ٨ محاولات بتباعد متزايد يصل إلى ساعة بين المحاولة والتي تليها، ثم يتعثر التسليم ويبقى قابلًا لإعادة الإرسال يدويًا. |
|---|
| إعادة الإرسال من | أي معرّف تسليم: تُعاد كل رسالة على حدة من سجل التسليمات في وضع الإدارة. لا توجد إعادة إرسال جماعية. |
|---|
| فتح نقطة النهاية المتعثرة | زر البطاقة: يفتح في وضع الإدارة النقطة صاحبة أكبر عدد إخفاقات متتالية أو أي نقطة غير نشطة. معطّل عندما تكون كل النقاط نشطة بلا إخفاقات. |
|---|
| عدادات الـ ٢٤ ساعة غير متاحة | حالة غير متاحة صريحة: لا تعيد الواجهة عدد التسليمات الناجحة والفاشلة في نافذة زمنية ولا وسيط زمن التسليم، فتُقرأ التسليمات لنقطة واحدة في وضع الإدارة بدل عرض أرقام مُختلقة. |
|---|
| الفشل يُعلَن بقصد | ملاحظة تشرح أن النقطة التي ترفض سلسلة من المحاولات ولا تقبل أي تسليم لمدة ساعة يوقفها الخادم ويسجّل الإيقاف في سجل التدقيق، وتبقى تسليماتها في الانتظار. |
|---|
| نقطة واحدة لا توقف البقية | ملاحظة تؤكد أن نقطة نهاية متعثرة لا تحجب بقية الاشتراكات ولا ناشر الأحداث. |
|---|
الإدارة: محرّر نقطة النهاية
| الحقل | المعنى |
|---|
| نقاط النهاية في المنشأة | قائمة السجلات: الاسم، ثم العنوان وعدد الإخفاقات المتتالية، وشارة الحالة. يُفتح المحرّر على أول نقطة حتى تختار غيرها. |
|---|
| النقطة | عنوان HTTPS للقراءة فقط؛ لا يمكن تعديله بعد الإنشاء، فأنشئ اشتراكًا جديدًا لعنوان جديد. |
|---|
| الحالة | حالة الاشتراك الحالية للقراءة فقط. عندما تكون «معطّل» تظهر تحتها ملاحظة «أوقف الخادم التسليم» وما ينبغي فعله. |
|---|
| إخفاقات متتالية | عدد الإخفاقات المتتالية الحالية لهذه النقطة، للقراءة فقط. |
|---|
| آخر تسليم | وقت آخر تسليم مقبول، أو «لم يُسلَّم بعد». |
|---|
| إصدارات المخطط المثبَّتة | لكل حدث مشترك فيه، إصدارات الحمولة الرئيسية التي يتلقاها هذا الاشتراك مثل v1. لن يصل إصدار لاحق حتى يُختار صراحةً؛ لا يوجد تحرير للتثبيت من هذه الشاشة. |
|---|
| إيقاف مؤقت / استئناف | إجراء واحد يتبدّل: «إيقاف مؤقت» لنقطة نشطة فتتجمّع أحداثها دون تسليم، و«استئناف» لنقطة موقوفة أو معطّلة فيستأنف التسليم من الأحداث الجديدة ويُصفَّر عدّاد الإخفاقات. |
|---|
| إرسال اختبار | يرسل حدث اختبار إلى النقطة؛ يظهر في سجل التسليمات كأي حدث آخر فتتحقق من أن طرفك يستقبل ويوقّع صحيحًا. |
|---|
| تدوير السر | إجراء خطر: يُصدر سرًا جديدًا يظهر مرة واحدة في بطاقة السر أعلى الصفحة، وتتوقف التوقيعات القديمة عن القبول فور التدوير. حدّث طرفك قبل الاعتماد على التسليمات التالية. |
|---|
جدول التسليمات
| الحقل | المعنى |
|---|
| الحدث | اسم الحدث الذي حُمل في هذا التسليم. «لا توجد تسليمات على هذا الاشتراك بعد» عندما لم يُرسل شيء. |
|---|
| الحالة | قيد الانتظار: لم تُقبل بعد وما زالت المحاولات جارية. مُسلَّم: قبلها طرفك. متعثر: استُنفدت المحاولات دون قبول، ويبقى التسليم قابلًا لإعادة الإرسال. |
|---|
| المحاولات | عدد المحاولات التي أُجريت لهذا التسليم حتى الآن من أصل ٨. |
|---|
| آخر رمز | رمز حالة HTTP الذي أعاده طرفك في آخر محاولة. شرطة عندما لم تصل أي استجابة. |
|---|
| إعادة الإرسال | زر في كل صف يُجري محاولة جديدة على الحدث نفسه دون تغيير الأصل، ويُسجَّل السبب باسمك. |
|---|
شريط الملخص
| الحقل | المعنى |
|---|
| نقاط النهاية | عدد الاشتراكات في المنشأة. |
|---|
| الأحداث | أسماء الأحداث المشترك فيها للنقطة المختارة، أو شرطة. |
|---|
| أُنشئ | تاريخ ووقت إنشاء الاشتراك المختار، أو شرطة. |
|---|
| ما تكتبه هذه الإجراءات | قائمة المسارات التي تستدعيها الصفحة عند الإنشاء وتدوير السر وإعادة الإرسال، مع أثر كل منها. |
|---|
نافذة اشتراك جديد
| الحقل | المعنى |
|---|
| اسم الاشتراك | اسم تعريفي يظهر في الجدول والقائمة. ثلاثة أحرف على الأقل. |
|---|
| عنوان HTTPS | العنوان الذي تُسلَّم إليه الأحداث. يجب أن يبدأ بـ https:// ويرفض الخادم أي شيء غيره. |
|---|
| الأحداث | رقائق للأحداث العشرة المتاحة (إنشاء الطلب ودفعه واسترداده وإلغاؤه، تغيّر المخزون، إنشاء العميل وتحديثه، نشر الكتالوج، إغلاق نقطة البيع، تغيّر حالة الفاتورة). order.created محدد ابتداءً، ويلزم حدث واحد على الأقل. |
|---|
| إنشاء الاشتراك | معطّل حتى يكتمل الاسم والعنوان وحدث واحد. عند النجاح يظهر سر التوقيع مرة واحدة في بطاقة أعلى الصفحة. |
|---|
حالات الوصول
| الحقل | المعنى |
|---|
| خارج صلاحيات دورك | تحتاج الصفحة كلها، بما فيها قائمة الاشتراكات، إلى صلاحية webhooks-manage؛ لا يوجد مستوى للقراءة فقط. بدونها تظهر شاشة «خارج صلاحيات دورك» مع اسم الصلاحية وزر العودة إلى الرئيسية. |
|---|
| غير مشمولة في خطتك | تظهر عندما لا تشمل خطتك قدرة «الواجهة البرمجية والتكاملات» integrations.api، مع اسم خطتك الحالية وزر التواصل مع أيدي للترقية. الاشتراكات القائمة محفوظة كما هي. |
|---|
| تعذر تحميل خطافات الويب | حالة خطأ تحل محل التقرير عندما تفشل قراءة الاشتراكات، مع زر «إعادة المحاولة». أخطاء الإنشاء والإيقاف والتدوير والاختبار وإعادة الإرسال تظهر كملاحظة تحذيرية أعلى الصفحة مع رمز الخطأ. |
|---|
