واجهة API لـ reCAPTCHA Enterprise v3
بقلم solvethree آخر تحديث
احصل على رمز reCAPTCHA v3 Enterprise من الواجهة الخلفية لديك. اضبط الموقع مرة واحدة، ثم أرسل اسم مضيفه والإجراء ووكيلًا. سنعيد الرمز مع وكيل المستخدم وتلميحات العميل لاستخدامها عند إرساله.
جرّب APIفي هذه الصفحة
إرسال الطلب
أعدّ ملف تعريف موقع نشطًا في مساحة عملك قبل أول عملية حل. أرسل اسم المضيف في site وإجراء reCAPTCHA الفعلي للصفحة في action. الخيار الافتراضي هو Enterprise v3؛ استخدم recaptchaType: v3 لإصدار v3 القياسي. لا تحتاج المهمة إلى type أو عنوان URL الكامل للصفحة أو مفتاح موقع.
أنشئ المهمة باستخدام POST https://api.solvethree.com/v1/tasks. صادِق باستخدام مفتاح API لمساحة العمل في ترويسة Authorization: Bearer.
{
"site": "example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example-recaptcha-001"
}أرسل الرمز
اقرأ solution.token عندما تصبح المهمة جاهزة. أرسله في حقل CAPTCHA في تطبيقك عبر الوكيل نفسه، باستخدام userAgent وsecChUa المُعادتين. نفّذ الحل قبيل الطلب الذي يحتاج إلى الرمز؛ ولا تُنشئ مخزونًا مؤقتًا من الرموز لاستخدامها لاحقًا.
تعني المهمة الجاهزة أنه تم إنشاء الحل. تحقّق من استجابة الوجهة المستهدفة لمعرفة ما إذا كانت قد قبلت الطلب.
الانتظار وانتهاء المهلة
ينتظر طلب الإنشاء مدة تصل إلى 15 ثانية افتراضيًا. استخدم ?waitMs=0 إذا كنت تفضّل استلام معرّف المهمة فورًا والاستعلام الدوري عنها.
توقّف عند ready أو failed. إذا انتهت مهلة الإنشاء، فأعد استخدام requestId الأصلي مع مدخلات مطابقة لاستعادة المهمة. قد يؤدي معرّف جديد إلى إنشاء عملية حل أخرى قابلة للفوترة.
السعر
$2.00 لكل 1,000 عملية حل، تُدفع من رصيد مساحة عملك. تُرد تكلفة عمليات الحل الفاشلة. ابدأ برصيد ترحيبي قدره $5؛ والحد الأدنى للإيداع المدفوع هو $10.