AUTH311: مسار REST مفقود

ماذا يعني هذا

مسار متجر WCPOS غير متاح.

اطلب من مسؤول الموقع التحقق مما إذا كانت إضافة حماية أو وكيل تحذف ترويسات طلبات WCPOS.

ما الذي ينبغي فعله

يلزم تغيير في الإعدادات قبل أن يعمل هذا. أعد المحاولة بعد إجراء التغيير أعلاه؛ فإعادة المحاولة من دونه ستفشل بالطريقة نفسها.

بياناتك

لا تتأثر أي بيانات طلبات أو منتجات. وإذا استمر هذا، فاسأل الشخص الذي يدير موقع WordPress لديك.

استكشاف الأخطاء

1. تأكد من أن WCPOS مفعّل على الموقع: WP Admin → الإضافات.
2. اختبر صيغتي REST المدعومتين كلتيهما في متصفح: عنوان /wp-json/ الخاص بمتجرك وعنوان /index.php?rest_route=/. ولا تشخّص وجود حجب لـ REST إلا إذا لم يُرجع أي من العنوانين استجابة JSON.
3. إذا لم تعمل أي من صيغتي REST، فاسأل مسؤول الموقع عما إذا كانت إضافة حماية أو وكيل أو شبكة CDN تحذف ترويسات طلبات WCPOS أو تحجب طلبات REST — فقواعد جدار الحماية وخيارات التشديد التي تعطّل REST API هي المتهم المعتاد.
4. على بعض الاستضافات، تؤدي إعادة حفظ الروابط الدائمة (الإعدادات → الروابط الدائمة → حفظ) إلى استعادة مسارات REST المفقودة.

أين تبحث

عندما يتمكن WCPOS من حفظ هذا الخطأ، يُسجَّل على الجهاز الذي أثاره. افتح صحة المتجر → السجلات (رمز نبض القلب أسفل درج التنقل)، وابحث عن الإدخال المعلَّم بهذا الرمز ووسّعه: يعرض الصف الموسّع السبب بلغة واضحة والسياق الذي التُقط لحظة حدوث العطل. وفي حالة طلب موجّه إلى المتجر، قد يشمل ذلك السياق رمز الخطأ الخاص بالخادم (serverCode)، أو حالة HTTP (status)، أو نقطة النهاية (endpoint)؛ وتعتمد الحقول المعروضة على موضع حدوث العطل. وعند الإبلاغ عن مشكلة، استخدم نسخ معلومات التصحيح أعلى شاشة السجلات (مشاركة معلومات التصحيح على الهواتف والأجهزة اللوحية) بدلًا من لقطات الشاشة: فهي تجمع إصدار التطبيق وحالة الاتصال وأحدث الأخطاء. وتُحفظ السجلات لمدة أقصاها 30 يومًا، لذا اجمعها بينما المشكلة لا تزال حديثة. وانسخ أيضًا أي خطأ في وحدة تحكم المتصفح ظهر قبل أن يتمكن POS من كتابة إدخال السجل الخاص به.

إلى جانب السجل داخل التطبيق، قد يترك هذا العطل أثرًا في:

• فاحص الشبكة (Network) (الويب وسطح المكتب): افتح أدوات المطوّر — اضغط F12 في المتصفح، أو متقدّم → تبديل أدوات المطوّر في قائمة تطبيق سطح المكتب — ثم اختر تبويب Network. اتبع إرشادات إعادة المحاولة الواردة في هذه الصفحة أولًا؛ ولا تُعِد تنفيذ الإجراء إلا عندما تؤكد تلك الخطوات أن ذلك آمن. ويعرض الطلب الفاشل حالة HTTP ونص الاستجابة الخام، بما في ذلك صفحات الأخطاء التي لا تصل إلى سجل POS أبدًا.
• WooCommerce → الحالة → السجلات: في موقع WordPress، راجع أحدث ملف fatal-errors-*.log بحثًا عن أعطال PHP، إضافة إلى أي مصدر سجل يحمل اسم إضافة متورطة في العطل. فالخطأ من فئة 500 القادم من المتجر يترك سببه هنا في معظم الحالات.

التفاصيل

• الرمز: AUTH311 (REST_ROUTE_MISSING)
• الخطورة: خطأ
• أُضيف في: WCPOS 1.10.0