आपका पहला समाधान
एक अनुरोध में टोकन, हेडर सेट या कुकी जनरेट करें और उसे उसी पहचान के साथ सबमिट करें जिसके लिए उसे जारी किया गया था।
त्वरित शुरुआत
बेस 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,000 $1.25 · विफल जॉब का क्रेडिट वापस
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 फ़िलहाल www.ticketmaster.com पर HTTPS लक्ष्यों का समर्थन करता है। लौटाई गई ब्राउज़र पहचान और सफल प्रॉक्सी के साथ हर लौटाया गया हेडर तुरंत लागू करें। हेडर सेट लक्ष्य, पहचान और इग्रेस से बँधे होते हैं। इन कार्यों को अपने प्लान में शामिल करने के लिए Kasada को असीमित प्लान के स्लॉट में आवंटित करें।
Ticketmaster TMPT जनरेट करें
प्रति 1,000 $0.99 · विफल जॉब का क्रेडिट वापस
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
}Ticketmaster URL आवश्यक है; अनुरोध ID नहीं। सटीक इवेंट URL के साथ ऐक्शन Event और साइन-इन प्रवेश URL के साथ Login इस्तेमाल करें। 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
}अधिकांश इंटीग्रेशन को इस अनुरोध की कभी ज़रूरत नहीं पड़ती। इसका उपयोग केवल तब करें जब बनाने की प्रतिक्रिया सिंक्रोनस अवधि के बाद भी pending या solving हो, या कनेक्शन टूटने के बाद इडेम्पोटेंट कार्य दोबारा प्राप्त करना हो। Kasada 75 सेकंड तक प्रतीक्षा करता है और reCAPTCHA 15 सेकंड का उपयोग करता है। TMPT डिफ़ॉल्ट रूप से 1.5 सेकंड तक प्रतीक्षा करता है; पूरी तरह असिंक्रोनस निर्माण के लिए waitMs=0 या 75 सेकंड तक का स्पष्ट TMPT waitMs इस्तेमाल करें।
विफलताएँ संभालें
status · failed
{
"id": "login_20260910_0001",
"status": "failed",
"errorCode": "site-unreachable",
"error": "target page did not respond",
"durationMs": 9210
}पहचान शामिल है
टोकन के साथ वही userAgent और secChUa मिलते हैं जिनके लिए उसे जारी किया गया था। उन्हें साथ भेजें।
विफल सॉल्व मुफ़्त हैं
जिस कार्य की अंतिम स्थिति failed होती है, उसका क्रेडिट अपने आप आपके बैलेंस में वापस आ जाता है।
सीक्रेट सुरक्षित
टोकन, कुकी, प्रॉक्सी और फ़िंगरप्रिंट कार्य सूचियों और लॉग में शामिल नहीं होते।