إعداد ملفات تعريف لأكثر من إجراء reCAPTCHA واحد

في ملفات تعريف المواقع، أعِدّ ملف تعريف واحدًا لكل اسم مضيف وإجراء التقاط ونوع reCAPTCHA. في هذا المثال، يستخدم كلا ملفَي التعريف accounts.example.com وEnterprise v3.

1. 1.

   أضف ملف تعريف تسجيل الدخول

   اختر «إضافة موقع». أدخل عنوان URL لصفحة HTTPS التي يُنفّذ فيها إجراء تسجيل الدخول، واختر Enterprise v3، واضبط «إجراء الالتقاط» على login. يدعم النموذج أيضًا قيمًا اختيارية لعنوان URL للتنقل ومفتاح الموقع وReferer. أرسل النموذج بالنقر على «إضافة الموقع».

2. 2.

   أضف ملف تعريف إتمام الشراء

   كرّر الخطوات لصفحة إتمام الشراء على اسم المضيف نفسه، مع إبقاء Enterprise v3 وضبط «إجراء الالتقاط» على checkout.

3. 3.

   تأكد من أن كلا ملفَي التعريف نشط

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

أرسل كل كائن أدناه كطلب POST /v1/tasks منفصل. استخدم مفتاح API لمساحة عملك للمصادقة عبر Authorization: Bearer، واحتفظ بهذا المفتاح على الخادم.

[
  {
    "site": "accounts.example.com",
    "action": "login",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "login-flow-001"
  },
  {
    "site": "accounts.example.com",
    "action": "checkout",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "checkout-flow-001"
  }
]

استبدل العنصرين النائبين لاسم المضيف والوكيل باسم مضيف الهدف وعنوان URL للوكيل لديك. يقدّم كل طلب proxy واحدًا؛ فلا تضف proxyCandidates أيضًا. تكون القيمة الافتراضية لـ recaptchaType عند حذفه هي enterprise-v3. لا تضف حقلَي type أو url إلى طلبات reCAPTCHA هذه.

تحدد قيمتا requestId مهمتين منطقيتين منفصلتين. استخدم معرّفًا جديدًا لعملية حل جديدة. إذا انتهت مهلة إنشاء المهمة، فأعِد استخدام المعرّف نفسه مع الطلب نفسه لاسترجاع المهمة الموجودة؛ تؤدي إعادة استخدام معرّف مع مدخلات مختلفة إلى تعارض.

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

يتطلب إجراء تنفيذ مختلف هدفًا ملتقطًا واحدًا لا لبس فيه. إذا كان هناك أكثر من هدف محتمل، فلا تفترض أن solvethree يختار ملف تعريف عشوائيًا. استخدم إجراء الالتقاط المُعدّ متى أمكن. إذا أُبلغ عن التباس في الاختيار، فقارِن اسم مضيف المهمة ونوع reCAPTCHA والإجراء بملفات التعريف في لوحة التحكم، واستخدم الاستجابة الفعلية من لوحة التحكم/API لتشخيص عدم التطابق.

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