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