اختبار CAPTCHA API في Insomnia

تحتاج إلى مفتاح API لمساحة العمل، وملف تعريف نشط للموقع المستهدف، ووكيل. أعدّ ملف تعريف الموقع قبل إرسال المهمة: فتوفير اسم مضيف وإجراء لا ينشئ ملف تعريف.

استخدم بيئة محلية خاصة باسم solvethree-local تتضمن المتغيرات أدناه. هذه أسماء اختيرت لهذا الدليل، وليست حقول API إضافية. لا تضع مفتاح API وبيانات اعتماد الوكيل في الإعدادات المشتركة.

1. 1.

   ضبط طلب الإنشاء

   أنشئ طلب POST باستخدام api_base متبوعًا بـ /tasks. أضف معامل الاستعلام waitMs بالقيمة 0. اختر مصادقة Bearer وقدّم api_key بوصفه الرمز؛ يجب أن يرسل الطلب ترويسة Authorization باستخدام مخطط Bearer.

2. 2.

   أنشئ جسم JSON

   اختر جسم JSON يحتوي على site وaction وproxy وrequestId. املأ الحقول الثلاثة الأولى من المتغيرات المحلية المطابقة لها، واملأ requestId من request_id. أرسل واحدًا فقط من proxy أو proxyCandidates؛ يستخدم هذا الدليل proxy. لا تضف type أو url. يؤدي حذف recaptchaType إلى اختيار القيمة الافتراضية، وهي enterprise-v3.

3. 3.

   أرسل الطلب وافحص الاستجابة

   تحقق من استجابة HTTP قبل قراءتها بوصفها بيانات مهمة ناجحة. إذا نجح الإنشاء، فانسخ معرّف المهمة المُعاد إلى task_id. احتفظ بجسم المهمة وrequest_id في متناولك تحسبًا للحاجة إلى استعادة الطلب.

4. 4.

   استرجع تلك المهمة

   أنشئ طلب GET باستخدام api_base متبوعًا بـ /tasks/ ومعرّف المهمة المنسوخ. اضبط waitMs على 15000، واستخدم مفتاح Bearer نفسه، واترك الجسم فارغًا. انسخ المعرّف يدويًا؛ لا يعتمد هذا الدليل على تعبير لربط الاستجابات.

Create task
  Method: POST
  URL: https://api.solvethree.com/v1/tasks?waitMs=0
  Auth: Bearer Token — your private workspace key
  Body: JSON — site, action, proxy and a stable requestId

Retrieve task
  Method: GET
  URL: https://api.solvethree.com/v1/tasks/PASTE_RETURNED_ID?waitMs=15000
  Auth: Bearer Token — the same workspace key
  Body: none

Keep the task's proxy in the JSON body. Insomnia's own network proxy setting
controls its API connection, not the proxy used to generate/submit the solution.

يعيد طلب HTTP استجابة غير ناجحة.

افحص خطأ HTTP قبل محاولة قراءة بيانات مهمة ناجحة.

جرّب هذا: صحح مشكلة الطلب أو المصادقة المُبلّغ عنها. لا تكرر إرسال مدخلات غير صالحة من دون تغيير، ولا تفترض أن كل خطأ يعني عدم كفاية الرصيد.

حالة المهمة هي pending أو solving.

لا تتضمن أي من الحالتين حلًا قابلًا للاستخدام.

جرّب هذا: أرسل طلب GET مجددًا لمعرّف المهمة نفسه. لا تنشئ مهمة أخرى لمجرد أن هذه المهمة لم تنتهِ بعد.

حالة المهمة هي failed.

اقرأ errorCode وerror؛ يُعدّ site-unreachable أحد أخطاء المهمة المحتملة.

جرّب هذا: توقف عن استرجاع تلك المهمة وعالج السبب المُبلّغ عنه قبل بدء أخرى. تُردّ تكلفة محاولات الحل الفاشلة.

تنتهي مهلة طلب الإنشاء من دون إعادة معرّف.

انتهاء مهلة الاتصال لا يثبت فشل الإنشاء.

جرّب هذا: أعد إرسال جسم المهمة نفسه باستخدام requestId نفسه لاستعادة المهمة الموجودة. يؤدي تغيير المدخلات مع إعادة استخدام ذلك المعرّف إلى تعارض.

توفر مهمة reCAPTCHA ذات الحالة ready رمزًا. إذا أرسلته إلى الهدف، فاستخدم userAgent وsecChUa المُعادين مع الوكيل نفسه المستخدم للحل. تؤكد استجابة الجاهزية توليد حل، وليس نجاح طلب تطبيقك.