حزم SDK وMCPOpenAPIمرجع Markdownالمنتجات المدعومة

الحل الأول لك

ولّد رمزًا أو مجموعة ترويسات أو ملف تعريف ارتباط في طلب واحد، وأرسله مع الهوية التي أُصدر لها.

REST · v1

البدء السريع

  1. 01توليد رمز
  2. 02توليد Kasada
  3. 03توليد TMPT
  4. 04البديل غير المتزامن
  5. 05معالجة حالات الفشل

عنوان URL الأساسي

https://api.solvethree.com/v1

المصادقة

Authorization: Bearer <key>

مرجع التكامل الكامل بصيغة Markdown.

توليد رمز

POST /v1/tasks · 201

curl https://api.solvethree.com/v1/tasks \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site": "accounts.example.com",
    "action": "login",
    "proxy": "http://user:[email protected]:8080",
    "requestId": "login_20260910_0001"
  }'
{
  "id": "login_20260910_0001",
  "status": "ready",
  "solution": {
    "token": "03AFcWeA5…kQ2b",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"140\", \"Not=A?Brand\";v=\"24\""
  },
  "durationMs": 1742
}

ينتظر طلب الإنشاء حتى 15 ثانية، ويُرجع عادةً الرمز المكتمل. يجب أن يكون للموقع ملف تعريف نشط في مساحة العمل هذه. يُغطّى الموقع المخصص لخطتك غير المحدودة ضمن الخطة؛ أما كل موقع آخر فيحجز وحدة رصيد واحدة بنظام الدفع حسب الاستخدام.

حقول اختيارية (يلزم proxy أو proxyCandidates)

recaptchaType
استخدم "v3" للإصدار v3 العادي. واحذفه لاستخدام القيمة الافتراضية "enterprise-v3" المتوافقة مع الإصدارات السابقة.
requestId
مفتاح منع التكرار الخاص بك، بطول 1–64 محرفًا. تؤدي إعادة إرساله إلى إرجاع المهمة نفسها.
proxyCandidates
حتى ستة وكلاء HTTP(S) مختلفين. يمثّل solution.egressAttempts فهرس المرشح الناجح، بدءًا من 1. تتطلب الجلسات وكيلًا واحدًا.
userAgent, secChUa
ثبّت هوية المتصفح التي ستستخدمها مع الرمز.
timezoneOffsetMinutes
طابق المنطقة الزمنية للعميل الذي يرسل الرمز.
session
احتفظ بجلسة عبر المهام لمسارات العمل متعددة الخطوات.

توليد ترويسات Kasada

$1.25 لكل 1,000 · تُسترد تكلفة المهام الفاشلة

curl https://api.solvethree.com/v1/tasks \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "KasadaTask",
    "url": "https://www.ticketmaster.com/discovery/v2/events",
    "proxy": "http://user:[email protected]:8080"
  }'
{
  "id": "req_92ad…",
  "status": "ready",
  "solution": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"151\", \"Google Chrome\";v=\"151\"",
    "headers": {
      "x-kpsdk-ct": "…",
      "x-kpsdk-cd": "…",
      "x-kpsdk-h": "…",
      "x-kpsdk-v": "…"
    },
    "egressAttempts": 1
  }
}

يدعم Kasada المستقل حاليًا أهداف HTTPS على www.ticketmaster.com. طبّق كل ترويسة مُرجعة فورًا مع هوية المتصفح المُرجعة والوكيل الناجح. ترتبط مجموعات الترويسات بالهدف والهوية ومسار الخروج. خصّص Kasada لخانة في الخطة غير المحدودة لتضمين هذه المهام في خطتك.

توليد Ticketmaster TMPT

$0.99 لكل 1,000 · تُسترد تكلفة المهام الفاشلة

curl 'https://api.solvethree.com/v1/tasks?waitMs=75000' \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "TicketmasterTmptTask",
    "url": "https://www.ticketmaster.com/example/event/1A2B3C4D5E6F7A8B",
    "action": "Event",
    "proxy": "http://user:[email protected]:8080"
  }'
{
  "id": "req_7f4c…",
  "status": "ready",
  "solution": {
    "token": "tmpt-cookie-value…",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"151\", \"Google Chrome\";v=\"151\"",
    "egressAttempts": 1
  },
  "durationMs": 2310
}

عنوان URL الخاص بـ Ticketmaster مطلوب؛ أما معرّف الطلب فليس مطلوبًا. استخدم الإجراء Event مع عنوان URL الدقيق للفعالية، وLogin مع عنوان URL لمدخل تسجيل الدخول. ينتظر إنشاء TMPT حتى 1.5 ثانية افتراضيًا ليتمكن الحل الجاهز من العودة مباشرةً؛ أما العمل الجديد فيعود كمهمة معلقة. اضبط معلمة استعلام URL على waitMs=0 للإنشاء غير المتزامن بالكامل، أو حتى waitMs=75000 لانتظار أطول بحد أقصى محدد، ثم افحص حالة المهمة واستعلم دوريًا إذا ظلت في حالة غير نهائية. الرمز هو القيمة الخام لملف تعريف الارتباط tmpt. خصّص Ticketmaster TMPT لخانة في الخطة غير المحدودة لتضمين هذه المهام في خطتك.

البديل غير المتزامن

GET /v1/tasks/:id · 200

curl https://api.solvethree.com/v1/tasks/login_20260910_0001 \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY"
pendingقُبلت المهمة ولم تُلتقط بعد.
solvingتقوم عملية عاملة بتوليد الرمز.
readyالرمز متاح في solution. احتُسبت الرسوم.
failedراجع errorCode. يُسترد الرصيد.
{
  "id": "login_20260910_0001",
  "status": "ready",
  "solution": {
    "token": "03AFcWeA5…kQ2b",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"140\", \"Not=A?Brand\";v=\"24\""
  },
  "durationMs": 1742
}

لا تحتاج معظم التكاملات إلى هذا الطلب مطلقًا. استخدمه فقط إذا ظلت استجابة الإنشاء في حالة pending أو solving بعد انتهاء مهلة الانتظار المتزامن، أو لاستعادة مهمة محمية من التكرار بعد انقطاع الاتصال. ينتظر Kasada حتى 75 ثانية، ويستخدم reCAPTCHA مهلة 15 ثانية. ينتظر TMPT حتى 1.5 ثانية افتراضيًا؛ استخدم waitMs=0 للإنشاء غير المتزامن بالكامل، أو قيمة صريحة لـ TMPT في waitMs تصل إلى 75 ثانية.

معالجة حالات الفشل

status · failed

{
  "id": "login_20260910_0001",
  "status": "failed",
  "errorCode": "site-unreachable",
  "error": "target page did not respond",
  "durationMs": 9210
}
401مفتاح API غير صالح
402الرصيد غير كافٍ
403ملف تعريف الموقع غير نشط
409تعارض في معرّف الطلب
429تم تجاوز حد المعدل · retry-after: 60
502خدمة التوليد غير متاحة · أُعيد الرصيد
503خدمة التوليد بلغت سعتها القصوى · أُعيد الرصيد · retry-after: 1

الهوية مضمّنة

يأتي الرمز مع userAgent وsecChUa اللذين أُصدر لهما. أرسلهما معه.

عمليات الحل الفاشلة مجانية

تُعاد تكلفة المهمة التي تنتهي بحالة failed إلى رصيدك تلقائيًا.

حماية الأسرار

لا تظهر الرموز وملفات تعريف الارتباط والوكلاء والبصمات في قوائم المهام والسجلات.

وثائق API · solvethree