اختبار solvethree في Postman

1. 1.

   استيراد ملف JSON الذي نزّلته

   في Postman، اختر استيراد وحدّد ملف المجموعة. يحتوي على طلبي إنشاء المهمة واسترجاع المهمة مع تفويض Bearer موروث وعناصر نائبة للمتغيرات.

2. 2.

   التحقّق من ملف تعريف الموقع

   تحتاج مساحة عملك إلى ملف تعريف نشط لاسم المضيف المستهدف. اضبطه في لوحة التحكم قبل الاختبار؛ فإرسال اسم مضيف وإجراء لا ينشئ ملف تعريف. راجع إعداد ملف تعريف الموقع.

3. 3.

   ضبط قيم البيئة الخاصة

   أنشئ بيئة لهذا الاختبار وحدّدها. املأ القيم أدناه بشكل خاص، بما في ذلك أي بيانات اعتماد للوكيل. لا تضع الأسرار مباشرة في المجموعة ولا تصدّر الأسرار المعبّأة.

4. 4.

   ضبط تفويض Bearer

   على مستوى المجموعة، حدّد Bearer Token وأشِر إلى متغير بيئة خاص يحتوي على مفتاح API لمساحة عملك. اترك كلا الطلبين مضبوطًا على وراثة التفويض. تتوقع API الترويسة Authorization: Bearer متبوعة بذلك المفتاح.

افتح طلب إنشاء المهمة. يرسل طلب POST إلى https://api.solvethree.com/v1/tasks بجسم JSON خام تُملأ قيمه من البيئة المحدّدة.

{
  "site": "{{SITE}}",
  "action": "{{ACTION}}",
  "proxy": "{{PROXY}}",
  "requestId": "{{REQUEST_ID}}"
}

يستخدم هذا الطلب reCAPTCHA Enterprise v3 افتراضيًا. لا تضف حقل type أو url. وهو يوفّر proxy واحدًا، لذا لا تضف proxyCandidates أيضًا: يلزم حقل واحد فقط من هذين الحقلين.

عيّن REQUEST_ID قبل الإرسال، ثم انقر على إرسال مرة واحدة. تحقّق من استجابة HTTP أولًا. إذا كانت غير ناجحة، فافحص خطأ الطلب بدلًا من اعتبار الجسم استجابة مهمة ناجحة. أصلح المدخلات غير الصالحة بدلًا من تكرار إرسالها دون تغيير.

عند نجاح استجابة الإنشاء، انسخ id المُعاد إلى قيمة البيئة الخاصة TASK_ID. لا تنقر على إنشاء المهمة مجددًا لمجرد التحقّق من التقدم.

افتح طلب استرجاع المهمة وتأكّد من أن TASK_ID يحتوي على معرّف المهمة المُعاد. يستخدم هذا الطلب GET /v1/tasks/:id على API نفسها. أرسله يدويًا، وتحقّق من استجابة HTTP، ثم افحص status للمهمة.

لا تعني HTTP 200 أو 201 وحدها أن الحل جاهز؛ وحدها status: ready تعني ذلك. يتحقّق هذا الاختبار اليدوي من إنشاء المهمة واسترجاعها، وليس من قبول الموقع المستهدف للنتيجة.

إذا تابعت بإرسال رمز reCAPTCHA إلى هدفه المقصود، فاستخدم هوية المتصفح المُعادة في userAgent وsecChUa والوكيل الذي نجح. لا تبدّل عناوين IP ولا تخلط معها هوية متصفح غير ذات صلة. قد يرفض الهدف الرمز حتى لو كان جاهزًا.

انتهاء مهلة الاتصال لا يثبت فشل الإنشاء. إذا كان لديك معرّف المهمة، فاسترجعها. إذا لم تستلم المعرّف مطلقًا، فأعِد إرسال طلب إنشاء المهمة باستخدام REQUEST_ID نفسه ومدخلات المهمة دون تغيير. يستردّ ذلك المهمة الموجودة بدلًا من إنشاء مهمة منطقية أخرى.

لا تولّد REQUEST_ID جديدًا لمجرد ضياع الاستجابة. تؤدي إعادة استخدام معرّف مع مدخلات مهمة مختلفة إلى تعارض؛ استخدم معرّفًا جديدًا عندما تبدأ مهمة جديدة عمدًا.