تجاوز إلى المحتوى الرئيسي
الإصدار: 1.x

API02003: توكن غير صالح

ماذا يعني هذا​

التوكن المستخدم في المصادقة غير معترف به من قبل الخادم. هذا يختلف عن التوكن المنتهي - هذا التوكن لم يكن صالحًا أبدًا أو تم إلغاء صلاحيته.

الأسباب الشائعة​

  • إلغاء التوكن — قام المسؤول بإلغاء الجلسة
  • تلف التوكن — تلف البيانات أثناء التخزين أو النقل
  • إعادة تعيين الخادم — تغير مفاتيح الخادم السرية، مما ألغى جميع التوكنات
  • خادم غير صحيح — الرمز المميز من تثبيت WordPress مختلف

تخصيص أخطاء الخادم​

يتم تشغيل هذا الرمز عندما يعيد الخادم:

كود الخادمالمصدر
jwt_auth_invalid_tokenمكون إضافي مصادقة JWT

كيفية الإصلاح​

1. تسجيل الدخول مرة أخرى​

امسح جلستك وأعِد المصادقة. إذا كان من المحتمل أن يحتوي هذا الجهاز على عمليات بيع لم تصل إلى متجرك، فأجرِ أولًا الفحص الوارد في التحذير في الخطوة 2:

  1. قم بتسجيل الخروج تمامًا
  2. أغلق وأعد فتح الـ POS
  3. سجل الدخول باستخدام بيانات الاعتماد الخاصة بك

2. مسح بيانات التطبيق​

تحقّق أولًا من عدم وجود عمل غير محفوظ

يؤدي مسح البيانات المحلية أو إعادة تثبيت التطبيق إلى حذف كل ما على هذا الجهاز ولم يصل إلى متجرك — بما في ذلك عمليات البيع المنفذة دون اتصال، وعربات التسوق المفتوحة، والتعديلات التي لم تُحفظ. قبل مسح أي شيء، افتح صحة المتجر → قاعدة البيانات وتحقق من عدم وجود أي شيء مدرج على أنه محتجز أو لم يصل إلى خادمك مطلقًا، ثم افتح صحة المتجر → السجلات للتحقق من وجود 0 سجل عالق و0 تغيير بانتظار الإرسال؛ وبعدها أكمِل كل عربة مفتوحة أو دوّن تفاصيلها. إذا لم تتوفر صفحة صحة المتجر في WCPOS، فحدّث WCPOS أولًا ثم تحقق. إذا كان هناك أي شيء مدرج أو بانتظار الإرسال، أو تعذّر عليك التحقق، فلا تمسح شيئًا — اطلب المساعدة من مالك المتجر أو اتصل بالدعم.

لا تفعل ذلك إلا إذا لم ينجح تسجيل الخروج، وبعد إجراء الفحص أعلاه فقط:

  • امسح ذاكرة التخزين المؤقت/البيانات الخاصة بتطبيق POS
  • على الويب: امسح ملفات تعريف الارتباط والتخزين المحلي للمتصفح لذلك الموقع
  • على سطح المكتب: تحقق من إعدادات التطبيق للعثور على خيار "مسح البيانات"

3. تحقق من إعدادات الخادم​

إذا كانت المشكلة تؤثر على جميع المستخدمين:

  • تحقق مما إذا كانت مفاتيح salts في WordPress قد تغيرت
  • تحقق من إعدادات مكون JWT أو المصادقة
  • مراجعة التغييرات الأخيرة على الخادم

4. تأكد من أنك على الخادم الصحيح​

تأكد من إعداد POS للاتصال بموقع WordPress الصحيح، خصوصًا إذا كان لديك عدة تثبيتات.

  • API02002 — توكن منتهي الصلاحية
  • API02008 — توكن التحديث غير صالح