حل reCAPTCHA v3 القياسي باستخدام API
لاستخدام reCAPTCHA v3 القياسي، اضبط recaptchaType على v3 في جسم المهمة. ولاستخدام reCAPTCHA Enterprise v3، استخدم enterprise-v3، وهي أيضًا القيمة الافتراضية عند حذف الحقل.
في هذه الصفحة
جهّز الملف التعريفي واسم المضيف والإجراء والوكيل
لا يزال v3 القياسي يتطلب ملف موقع تعريفيًا نشطًا متاحًا لمساحة عملك. أعدّ الموقع المستهدف في لوحة التحكم قبل إنشاء مهمة؛ فإرسال اسم مضيف وإجراء لا ينشئ الملف التعريفي.
site: اسم المضيف المستهدف، مثلaccounts.example.com، وليس عنوان URL كاملًا لصفحة.action: الإجراء المستخدم في تكامل reCAPTCHA لدى الجهة المستهدفة. استبدلloginفي المثال إذا كانت الجهة المستهدفة تستخدم إجراءً آخر. راجع كيفية العثور على الإجراء.proxyأوproxyCandidates: قدّم أحدهما فقط. يستخدم المثال وكيلًا واحدًا. إذا استخدمت قائمة مرشحين بدلًا منه، فتقبل القائمة بحد أقصى اثني عشر عنوان URL مميزًا لوكلاء HTTP أو HTTPS، دون مسار أو استعلام أو جزء مُعرِّف.
أرسل مهمة v3 القياسية
أرسل جسم JSON هذا إلى POST https://api.solvethree.com/v1/tasks. صادِق باستخدام مفتاح API لمساحة العمل في ترويسة Authorization وفق مخطط Bearer. احتفظ بالمفتاح على خادمك.
{
"site": "accounts.example.com",
"action": "login",
"recaptchaType": "v3",
"proxy": "http://user:[email protected]:8080",
"requestId": "v3-login-001"
}يُوضع recaptchaType في المستوى الأعلى، إلى جانب site وaction وproxy. لا تضف حقل type أو url عند استخدام reCAPTCHA.
استبدل اسم المضيف والإجراء والوكيل في المثال بقيم الجهة المستهدفة. استخدم requestId جديدًا لكل عملية حل منطقية جديدة. إذا انتهت مهلة الإنشاء، فأعد إرسال جسم المهمة نفسه بالمعرّف نفسه لاستعادة المهمة الحالية بدلًا من إنشاء أخرى. تؤدي إعادة استخدام ذلك المعرّف مع مدخلات مختلفة إلى تعارض.
انتظر حتى تصبح المهمة جاهزة، ثم أرسل الرمز
- 1.
تحقّق من استجابة HTTP أولًا
عالِج استجابة HTTP غير الناجحة قبل قراءة جسمها بوصفه نتيجة مهمة. تحقّق من الحالة وأصلح خطأ الطلب المُبلّغ عنه.
- 2.
استرجع المهمة حتى تكتمل
ينتظر الإنشاء مدة تصل إلى 15 ثانية افتراضيًا؛ أضف وقتًا إضافيًا إلى مهلة عميلك لاستيعاب تأخيرات الشبكة. إذا كانت الحالة
pendingأوsolving، فاسترجع المهمة باستخدامGET /v1/tasks/:id. لا ينتظر استطلاع GET افتراضيًا؛ وللاستطلاع الطويل، مرّرwaitMsبقيمة تصل إلى 15000 كمعامل استعلام في عنوان URL، وليس كحقل JSON. أوقف الاستطلاع عندreadyأوfailed. عندfailed، افحصerrorCodeوerrorقبل تحديد ما إذا كانت محاولة أخرى مجدية. - 3.
استخدم الحل الجاهز
أرسل
solution.tokenإلى الجهة المستهدفة المقصودة، وليس معرّف المهمة. استخدمuserAgentوsecChUaالمُعادَين، إلى جانب الوكيل الذي نجح في الحل. لا تبدّل عناوين IP أو تستخدم هوية متصفح غير مرتبطة بين الحل والإرسال.
الرمز الجاهز ليس دليلًا على درجة reCAPTCHA معيّنة أو على قبول الجهة المستهدفة له. ينتج reCAPTCHA v3 درجة مخاطر وإجراءً تقيّمهما الجهة المستهدفة في نظامها الخلفي؛ تحقّق من استجابتها للطلب الذي يرسل الرمز.
المصادر ومرجع API
شغّل مهمتك الأولى.
ابدأ برصيد قدره $5 في مساحة العمل.