הפתרון הראשון שלכם
צרו טוקן, ערכת כותרות או עוגייה בבקשה אחת, ושלחו אותם עם הזהות שעבורה הונפקו.
התחלה מהירה
כתובת 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"{
"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
}ברוב האינטגרציות אין צורך בבקשה הזו. השתמשו בה רק אם תגובת היצירה נשארת במצב ממתין או בפתרון לאחר חלון ההמתנה הסינכרוני, או כדי לשחזר משימה אידמפוטנטית אחרי ניתוק בחיבור. Kasada ממתין עד 75 שניות ו-reCAPTCHA משתמש ב-15 שניות. TMPT ממתין עד 1.5 שניות כברירת מחדל; השתמשו ב-waitMs=0 ליצירה אסינכרונית לחלוטין, או בערך waitMs מפורש של TMPT עד 75 שניות.
טיפול בכשלים
status · failed
{
"id": "login_20260910_0001",
"status": "failed",
"errorCode": "site-unreachable",
"error": "target page did not respond",
"durationMs": 9210
}הזהות כלולה
הטוקן מגיע עם userAgent ו-secChUa שעבורם הונפק. שלחו אותם יחד.
פתרונות שנכשלו הם ללא עלות
החיוב על משימה שמסתיימת במצב failed מוחזר אוטומטית ליתרה שלכם.
שמירה על סודות
טוקנים, עוגיות, שרתי פרוקסי וטביעות אצבע אינם נכללים ברשימות המשימות וביומנים.