لماذا يستخدم solvethree ملف تعريف موقع بدلًا من حقل websiteKey؟
يحتفظ solvethree بمفتاح موقع reCAPTCHA وإعداد الصفحة في ملف تعريف موقع. يوفّر طلب المهمة اسم المضيف في site، وإجراء التنفيذ في action، وبروكسي، وليس websiteKey أو websiteURL.
إذا كنت تنتقل من API أخرى، فالأمر ليس مجرد إعادة تسمية حقل. أعدّ ملف تعريف نشطًا في مساحة عملك أولًا؛ فإرسال اسم مضيف أو إجراء أو مفتاح موقع لا ينشئ ملف تعريف.
في هذه الصفحة
اضبط مفتاح الموقع والصفحة في لوحة التحكم
- 1.
افتح «إضافة موقع»
انتقل إلى ملفات تعريف المواقع واختر إضافة موقع. أدخل عنوان URL لصفحة HTTPS المستهدفة. ستستخدم المهمة اسم المضيف الخاص به، وليس عنوان URL الكامل هذا. أدخل عنوان URL الاختياري للتنقل وقيمة Referer عند الحاجة لإعداد الصفحة.
- 2.
اختر النوع وتحقق من مفتاح الموقع
اختر Enterprise v3 لتكامل reCAPTCHA Enterprise، أو Regular v3 لتكامل reCAPTCHA v3 العادي. يمكن للنموذج اكتشاف مفتاح الموقع تلقائيًا؛ ويمكنك إدخال قيمة بديلة في حقل مفتاح الموقع الاختياري.
- 3.
اضبط إجراء الالتقاط
إجراء الالتقاط مطلوب. للطلب أدناه، اضبط ملف تعريف بإجراء الالتقاط
login. يمكن لملفات تعريف النظام التي خضعت للمراجعة تعبئة إعداد الصفحة المعروف وإجراء الالتقاط دون جلب مباشر؛ اقرأ شرح النموذج للإجراء المختار. - 4.
أرسل وانتظر التفعيل
اختر إضافة موقع. قد تمر الطلبات بحالات الانتظار أو الالتقاط أو التحقق أو المراجعة قبل أن تصبح نشطة؛ ولا توجد مدة مضمونة للالتقاط. تعرض بعض الحسابات خيار إضافة رصيد للمتابعة. إذا فشل الالتقاط، فافحص السبب قبل إعادة المحاولة.
استخدم ملف تعريف واحدًا لكل تركيبة من اسم المضيف وإجراء الالتقاط ونوع reCAPTCHA. يحدد التطابق التام مع إجراء التنفيذ ملف التعريف الخاص به. تتطلب إجراءات التنفيذ الأخرى هدف التقاط واحدًا لا لبس فيه، لذا لا تفترض أن ملف تعريف واحدًا لاسم مضيف يغطي كل الإجراءات.
أرسل طلب المهمة دون تداخل
بمجرد أن يصبح ملف التعريف نشطًا، أرسل هذا الكائن مباشرةً بوصفه جسم JSON إلى POST /v1/tasks. استخدم للمصادقة Authorization: Bearer متبوعًا بمفتاح API لمساحة عملك، واحتفظ بهذا المفتاح على الخادم.
{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example_login_001"
}siteهو اسم المضيف: دون مخطط أو مسار أو استعلام. مكان عنوان URL الكامل للصفحة هو ملف التعريف في لوحة التحكم.actionهو إجراء التنفيذ لهذه المهمة. هنا، يطابقloginإجراء الالتقاط الذي ضُبط أعلاه.- يوفّر
proxyالبروكسي المستخدم للحل. يلزم توفير واحد فقط منproxyأوproxyCandidates؛ لا ترسلهما معًا. requestIdاختياري. إذا انتهت مهلة الإنشاء، فإن إعادة إرسال الطلب نفسه بالمعرّف نفسه تُعيد المهمة الحالية. تغيير مُدخلات المهمة مع إعادة استخدام ذلك المعرّف يسبب تعارضًا.
لا تنقل websiteKey أو websiteURL أو type أو url من بنية طلب API السابقة. بالنسبة إلى reCAPTCHA، تكون القيمة الافتراضية لـ recaptchaType هي enterprise-v3، ولهذا يحذفها المثال. يستخدم Regular v3 الحقل recaptchaType بالقيمة v3.
المصادر ومرجع API
شغّل مهمتك الأولى.
ابدأ برصيد قدره $5 في مساحة العمل.