أول عملية حل CAPTCHA لك على solvethree

1. 1.

   سجّل وأعدّ مساحة العمل

   ابدأ من التسجيل. استخدم مساحة العمل نفسها لمفتاح API وملف تعريف الموقع والرصيد.

2. 2.

   أنشئ مفتاحًا

   افتح مفاتيح API في لوحة التحكم. اختر «إنشاء مفتاح API»، وأدخل «اسم المفتاح»، ثم اختر «إنشاء مفتاح».

3. 3.

   احفظ القيمة السرية

   انسخ القيمة السرية المعروضة ضمن «احفظ مفتاح API» وخزّنها بأمان قبل اختيار «لقد حفظت هذا المفتاح». لن يتيح لك «إظهار البادئات» استعادة القيمة السرية الكاملة لاحقًا. احتفظ بالمفتاح على خادمك، لا في شيفرة المتصفح.

الرصيد الترحيبي هو $5. وإذا احتجت إلى إضافة أموال، فالحد الأدنى للإيداع هو $10. تبلغ تكلفة reCAPTCHA ‏$2.00 لكل 1,000 عملية حل؛ تُحتسب رسوم المهمة الجاهزة وتُرد تكلفة عملية الحل الفاشلة.

1. 1.

   أضف الصفحة المستهدفة

   افتح ملفات تعريف المواقع واختر «إضافة موقع». أدخل عنوان URL لصفحة الجهة المستهدفة ببروتوكول HTTPS، واختر Enterprise v3.

2. 2.

   حدّد إجراء الالتقاط

   استخدم الإجراء المطلوب للعملية التي تدمجها. يستخدم مثال الطلب أدناه login، لذا لا تستخدمه إلا إذا كان الإجراء الفعلي لدى الجهة المستهدفة. أضف ملف تعريف واحدًا لكل تركيبة من اسم المضيف وإجراء الالتقاط ونوع reCAPTCHA.

3. 3.

   انتظر حتى تصبح الحالة نشطة

   اختر «إضافة موقع». ستظهر لبعض الحسابات أولًا عبارة «أضف رصيدًا للمتابعة». بحسب الطلب المقدّم، قد يمر ملف التعريف بحالات الالتقاط أو التحقق أو المراجعة. لا تتابع إلا عندما يصبح نشطًا؛ فلا توجد مدة مضمونة للالتقاط. إذا فشل الالتقاط، فاقرأ السبب قبل إعادة المحاولة.

إرسال اسم مضيف وإجراء ضمن مهمة لا يُنشئ ملف تعريف. لعملية الحل الأولى هذه، استخدم في المهمة إجراء الالتقاط المطابق تمامًا لما في ملف التعريف. راجع إعداد ملف تعريف الموقع لمعرفة الحقول الاختيارية واختيار الإجراء.

أرسل النص التالي إلى POST https://api.solvethree.com/v1/tasks. صادِق الطلب باستخدام الترويسة Authorization مع Bearer متبوعًا بمفتاح API لمساحة العمل.

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• استبدل site باسم المضيف المستهدف، لا بعنوان URL الكامل لصفحته. واستبدل action بالإجراء المحدّد لعملية الحل الأولى.
• استبدل proxy بعنوان URL لوكيل HTTP وبيانات اعتماده. يستخدم هذا الطلب وكيلًا واحدًا؛ فلا تُرسل proxyCandidates أيضًا.
• اختر requestId لهذا الطلب المنطقي واحتفظ به مع المدخلات المُرسلة. يقبل من 1–64 حرفًا من أحرف ASCII أو أرقامًا أو شرطات سفلية أو شرطات.
• لا تُدرج type وurl. عند حذف recaptchaType، يستخدم الطلب Enterprise v3 افتراضيًا.

للحصول على تنفيذ كامل بلغة Python، استخدم reCAPTCHA Enterprise في Python. يوضّح الطلب هنا القيم التي تحتاج إلى إعدادها أولًا.

احتفظ بمعرّف المهمة المُرجع عند الإنشاء. استرجعها باستخدام GET https://api.solvethree.com/v1/tasks/:id، مع استبدال :id بذلك المعرّف واستخدام مصادقة Bearer نفسها.

• تحقّق من عدم وجود استجابة HTTP غير ناجحة قبل قراءة النص بوصفه استجابة مهمة ناجحة.
• ما دامت الحالة pending أو solving، فواصل الاستعلام الدوري. لا تحتوي أيٌّ من الحالتين على حل قابل للاستخدام.
• عندما تكون الحالة ready، أوقف الاستعلام الدوري واقرأ solution.
• عندما تكون الحالة failed، أوقف الاستعلام الدوري وافحص errorCode وerror. تُرد تكلفة عملية الحل الفاشلة.

تأتي استجابة المهمة الجاهزة بهذا الشكل. قيم الرمز وهوية المتصفح هذه قيم نائبة، وليست حلًا فعليًا.

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

1. 1.

   أرسل الرمز، لا معرّف المهمة

   ضع solution.token في الموضع الذي تتوقع فيه الجهة المستهدفة المقصودة رمز reCAPTCHA. افحص الطلب الصادر للتأكد من أنه لا يرسل معرّف المهمة أو رمزًا قديمًا.

2. 2.

   استخدم هوية المتصفح المُرجعة

   استخدم solution.userAgent وsolution.secChUa في الطلب الموجّه إلى الجهة المستهدفة، مع الوكيل نفسه الذي قدّمته لعملية الحل هذه. لا تخلطهما بهوية متصفح غير مرتبطة، ولا ترسل الرمز إلى عنوان URL مستهدف مختلف.

3. 3.

   تحقّق من استجابة الجهة المستهدفة

   تأكّد من أن الجهة المستهدفة قبلت العملية المقصودة. تعني المهمة الجاهزة أن solvethree أنشأ حلًا؛ ولا تضمن قبول الجهة المستهدفة لطلبك اللاحق.

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