UNLOCK API
مفتاح API
رموز الأخطاء
MarkdownOpenAPI

رموز الأخطاء

طرق JSON ترجع errorId 1 مع errorCode وerrorDescription. يرجع in.php وres.php اسم الخطأ كنص، أو {"status":0,"request":"ERROR_NAME"} مع json=1. حالة HTTP هي 200 في الحالتين، لذا اقرأ الجسم دائمًا.

المفتاح والحساب والحدود

  • ERROR_KEY_DOES_NOT_EXIST
    يُرجع من: JSONبدون خصم

    المفتاح غير صحيح. انسخه مرة أخرى من صفحة الحساب. (في in.php وres.php: ERROR_WRONG_USER_KEY)

  • ERROR_WRONG_USER_KEY
    يُرجع من: in.php، res.phpبدون خصم

    in.php وres.php: المفتاح خاطئ. انسخه مرة أخرى من صفحة الحساب.

  • ERROR_IP_NOT_ALLOWED
    يُرجع من: كلاهمابدون خصم

    جاء الطلب من عنوان IP غير موجود في قائمة الحساب المسموحة. أضف العنوان من صفحة الحساب.

  • ERROR_IP_BANNED
    يُرجع من: كلاهمابدون خصم

    هذا الحساب محظور. تواصل مع الدعم من صفحة الحساب.

  • ERROR_ZERO_BALANCE
    يُرجع من: كلاهمابدون خصم

    الرصيد لا يكفي للمهمة. اشحن رصيدك، ولم يُخصم أي شيء.

  • ERROR_TOO_MANY_REQUESTS
    يُرجع من: كلاهمابدون خصم

    طلبات كثيرة. خفّف التحقق من النتيجة إلى مرة كل 5 ثوانٍ.

رفض المهمة عند إرسالها

  • ERROR_TASK_NOT_SUPPORTED
    يُرجع من: JSONبدون خصم

    نوع المهمة غير معروف أو معطل. تحقق من اسم النوع.

  • ERROR_BAD_PARAMETERS
    يُرجع من: كلاهمابدون خصم

    حقل مطلوب مفقود أو بصيغة خاطئة.

  • ERROR_PAGEURL
    يُرجع من: كلاهمابدون خصم

    قيمة websiteURL أو pageurl مفقودة أو ليست عنوان http(s) كاملًا.

  • ERROR_GOOGLEKEY
    يُرجع من: in.php، res.phpبدون خصم

    قيمة googlekey مفقودة في طلب reCAPTCHA عبر in.php.

  • ERROR_BAD_PROXY
    يُرجع من: كلاهمابدون خصم

    مهمة البروكسي تحتاج إلى proxyAddress وproxyPort.

  • ERROR_ZERO_CAPTCHA_FILESIZE
    يُرجع من: كلاهمابدون خصم

    الصورة مفقودة أو صغيرة جدًا.

  • ERROR_TOO_BIG_CAPTCHA_FILESIZE
    يُرجع من: كلاهمابدون خصم

    حجم الصورة أكبر من 100 KB.

  • ERROR_IMAGE_TYPE_NOT_SUPPORTED
    يُرجع من: كلاهمابدون خصم

    الصورة ليست بصيغة base64 صالحة.

  • ERROR_NO_SLOT_AVAILABLE
    يُرجع من: كلاهمابدون خصم

    الطلبات كثيرة الآن، فلم تُقبل المهمة. حاول مرة أخرى بعد بضع ثوانٍ، ولم يُخصم أي شيء.

التحقق من النتيجة

  • CAPCHA_NOT_READY
    يُرجع من: in.php، res.phpبدون خصم

    في in.php وres.php فقط: المهمة ما زالت قيد التنفيذ. تحقق مرة أخرى بعد 5 ثوانٍ.

  • ERROR_WRONG_CAPTCHA_ID
    يُرجع من: كلاهمابدون خصم

    لا توجد مهمة بهذا المعرف في حسابك.

  • ERROR_WRONG_ID_FORMAT
    يُرجع من: in.php، res.phpبدون خصم

    res.php: المعرّف مفقود أو ليس رقمًا.

  • ERROR_CAPTCHA_UNSOLVABLE
    يُرجع من: كلاهمامسترد

    تعذر حل المهمة في الوقت المحدد. عاد مبلغها إلى رصيدك.

  • ERROR_PROXY_CONNECTION_FAILED
    يُرجع من: كلاهمامسترد

    لم يتمكن الحلّال من الاتصال عبر البروكسي الخاص بك. تأكد من أنه يعمل وأن بيانات الدخول صحيحة.

قد تفشل المهمة أيضًا بعد قبولها، مثلًا عندما تكون معاملات الصفحة خاطئة. عندها ترجع getTaskResult السبب في errorCode (أحد الرموز أعلاه)، ويكون المبلغ قد عاد إلى الرصيد.