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

افحص رمز الخطأ أولًا ثم إعداداته. في الاستجابة، request_id يساعد في إيجاد العملية بالسجل؛ لا تضع المفاتيح الكاملة في السجلات أو الصور.

ماذا أفحص عند فشل التفعيل؟

تحقق من الوصول للخادم ومعرّف المنتج واكتمال رمز الترخيص وتطابق المنتج. قبل نشر الخادم لا يمكن لحاسوب العميل استخدام عنوانك 127.0.0.1 ؛ فهذا العنوان يشير إلى حاسوب العميل نفسه.

رمز الخطأ	الخطوة الأولى
`LICENSE_INVALID`	راجع معرّف المنتج والمفتاح الكامل ومنتج الترخيص
`LICENSE_EXPIRED`	راجع الانتهاء؛ يجدده المورّد عند الحاجة
`LICENSE_REVOKED` `DEVICE_RELEASED`	الترخيص ملغى أو الجهاز محرر؛ يمسح SDK الذاكرة
`DEVICE_LIMIT_REACHED`	مواضع الترخيص ممتلئة؛ حرر جهازًا أو زد الحد
`API_QUOTA_EXCEEDED`	نفدت حصة API؛ راجع الفترة والباقة
`API_BALANCE_INSUFFICIENT`	رصيد تجاوز API غير كافٍ؛ راجع العملة والبيئة
`MONTHLY_QUOTA_EXCEEDED`	بلغ حد أجهزة المنصة، مستقل عن حد الترخيص
`IDEMPOTENCY_CONFLICT`	مفتاح واحد لأجسام مختلفة؛ جديد للعملية الجديدة، والقديم عند الإعادة بنفس الجسم
`IDEMPOTENCY_EXPIRED`	الاستجابة أو الربط القديم غير صالح؛ راجع الحالة ومفتاحًا جديدًا لعملية جديدة

لماذا يستمر العمل دون اتصال؟

دون اتصال يتحقق SDK محليًا من التوقيع والمنتج والجهاز والميزات والانتهاء؛ يُحذف طلب الخادم فقط. الذاكرة المنتهية أو رفض متصل صريح بالإلغاء أو التحرير يمنع الاستمرار.

لماذا يفشل فحص التوقيع أو الجهاز؟

قد يفشل التحقق بسبب مفتاح عام مختلف أو ذاكرة منتج آخر أو نسخة على حاسوب آخر. راجع trusted_keys يستخدم معرّف المفتاح والمفتاح العام للمنتج الحالي، ثم تحقق من تبديل النظام أو إعادة تثبيته.

يعرض SDK clock rollback ؛ تحقق من رجوع الساعة، صححها ثم حدّث عند الاتصال.

استجابة الخطأ الكاملة

{
  "error": {
    "code": "LICENSE_REVOKED",
    "message": "License was revoked"
  },
  "request_id": "99999999-9999-4999-8999-999999999999"
}

الحقل	المعنى والإجراء
`error.code` · string	معرّف خطأ ثابت لمنطق البرنامج بدل نص message.
`error.message` · string	سبب مقروء للتشخيص أو لصياغة رسالة العميل.
`request_id` · UUID	معرّف HTTP من الخادم للسجلات؛ ليس الترخيص أو Idempotency-Key.

For 400 / 415 correct fields or Content-Type; for 401 check the management key; for 403 inspect the licensing error; for 409 check limits, session state or idempotency conflicts; for 429 wait according to Retry-After. Runtime retries retain their Idempotency-Key and body. Recover management writes using each operation’s idempotency rules; never blindly repeat ordinary issuance or renewal after a timeout.

كيف أقرأ استجابة JSON؟

استجابة ناجحة data و request_id؛ والفشل يعيد error.code، error.message و request_id. احفظ رمز الخطأ وrequest_id لتحديد المشكلة.

للبريد والدفع والنشر راجع الدعم واستكشاف الأخطاء.