حل المشكلات

‏API، رسائل CLI وCI

ماذا تعني رسائل الباقة والحدود من Mokxi API وأداة سطر الأوامر وGitHub Action.

ما تراه

يطبع أداة سطر الأوامر الخطأ بصيغة mokxi: <message> (<code>, <request id>). تعيد الـAPI نفس الرسالة والرمز في إجابتها بصيغة JSON. الرمز بين القوسين هو العنوان أدناه. أرسل معرّف الطلب عند مراسلتنا.

How each tool works is in ‏Mokxi API، the command line tool and CI؛ إضافة VS Code موجودة في GitHub و VS Code.

دقائق المحاكاة (quota_exceeded)

"لقد استخدمت كل دقائق المحاكاة N التي تتضمنها باقتك هذا الشهر." الوقت المُحاكى عبر الـAPI يُحتسب ضمن كمية شهرية: 100 دقيقة على الباقة المجانية، و2,000 على Pro وStudent وTeacher وClassroom، و5,000 على Ultra ‏(لم تعد تُباع؛ الحسابات التي لديها تحتفظ بها). على Teacher وClassroom يتشارك المعلّم وفصله مجمعًا واحدًا، لذا قد تقول الرسالة "فصلك" بدلًا من ذلك. يبدأ العد من جديد في أول الشهر ‏(بتوقيت UTC)، وهو ما تذكره الرسالة. التشغيل الذي بدأ تحت الحد يكتمل دائمًا، ولا يُحصَّل أي مبلغ إطلاقًا على التجاوز. الدوائر التي تعمل في المحرر لا تُحتسب أبدًا.

طلبات كثيرة جدًا (rate_limited)

  • "تسمح باقتك بـ N طلبات في الدقيقة لكل رمز" أو "N محاكاة في الساعة لكل رمز". 60 طلبًا في الدقيقة و30 محاكاة في الساعة على الباقة المجانية، و600 من كل منهما على الباقات المدفوعة. انتظر عدد الثواني الذي يحدده ترويسة Retry-After.
  • "عدد كبير جدًا من الطلبات دون رمز؛ أرسل رمزًا للحصول على حد باقتك."
  • "المدة X ميلي ثانية؛ تعمل باقتك على N ميلي ثانية كحد أقصى من الوقت المُحاكى لكل طلب." 10 ثوانٍ من الوقت المُحاكى في التشغيل الواحد على الباقة المجانية، و60 على الباقات المدفوعة. قسّم التشغيل الطويل إلى تشغيلات أقصر.

الرموز (unauthorized و insufficient_scope و token_limit)

  • "Send your token as "Authorization: Bearer mkx_..."", "that token is not valid", "was revoked" or "has expired". Make a new token on API tokens in الإعدادات، أو سجّل الدخول مرة أخرى باستخدام mokxi login.
  • "هذا الرمز لا يملك نطاق ..." أنشئ رمزًا مع تحديد ذلك النطاق: simulate للتشغيلات، وprojects:read وprojects:write للمشاريع.
  • "تحفظ باقتك N من رموز API في الوقت نفسه؛ ألغِ أحدها أولًا." 5 على الباقة المجانية، و25 على الباقات المدفوعة.
  • "هذا الرمز غير معروف أو منتهي الصلاحية؛ ابدأ من جديد" (mokxi login). شغّل تسجيل الدخول مرة أخرى ووافق على الرمز الجديد خلال دقائق قليلة.

يلزمك باقة (license_required)

  • "‏Mokxi for VS Code جزء من Pro." ابدأ التجربة المجانية لمدة 7 أيام في Pro، أو اختر Pro على /pricing.
  • "‏Mokxi CI مجاني للمستودعات العامة." التشغيلات من GitHub Action، أو من سطر الأوامر داخل مهمة CI، على مستودع خاص تحتاج رمز CI من حساب Pro (عيّنه كـ MOKXI_TOKEN، أو كمدخل token في الـ Action). ميزة CI للمستودعات الخاصة تأتي مع Pro، وسعر الطلاب، وLifetime، وClassroom، والتجربة المجانية، ومع Ultra للحسابات التي ما زالت تملكها. تشغيل كود على حاسوبك الخاص باستخدام mokxi run يبقى مجانيًا، دون حساب.
  • "... You can keep using it until then." (December 11, 2026) A notice, not an error: accounts that used VS Code or CI before the change keep it until that date.

ما زلت عالقًا

راسلنا من /support مع النص الحرفي للرسالة ومعرّف الطلب (request id).