Ihre erste Lösung
Generieren Sie ein Token, einen Header-Satz oder ein Cookie mit einer einzigen Anfrage und übermitteln Sie es mit der Identität, für die es ausgestellt wurde.
Schnellstart
Basis-URL
https://api.solvethree.com/v1
Authentifizierung
Authorization: Bearer <key>
Vollständige Integrationsreferenz im Markdown-Format.
Token generieren
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
}Die Erstellungsanfrage wartet bis zu 15 Sekunden und gibt normalerweise das fertige Token zurück. Die Website muss ein aktives Profil in diesem Workspace haben. Eine Ihrem unbegrenzten Tarif zugewiesene Website ist enthalten; jede andere Website reserviert eine nutzungsbasierte Guthabeneinheit.
Optionale Felder (proxy oder proxyCandidates ist erforderlich)
- recaptchaType
- Verwenden Sie "v3" für reguläres v3. Lassen Sie den Wert weg, um den abwärtskompatiblen Standard "enterprise-v3" zu verwenden.
- requestId
- Ihr eigener Idempotenzschlüssel mit 1–64 Zeichen. Erneutes Senden gibt dieselbe Aufgabe zurück.
- proxyCandidates
- Bis zu sechs unterschiedliche HTTP(S)-Proxys. solution.egressAttempts ist der bei eins beginnende Index des erfolgreichen Kandidaten. Sitzungen erfordern einen einzelnen Proxy.
- userAgent, secChUa
- Legen Sie die Browseridentität fest, die Sie mit dem Token verwenden werden.
- timezoneOffsetMinutes
- Verwenden Sie die Zeitzone des Clients, der das Token übermittelt.
- session
- Behalten Sie bei mehrstufigen Abläufen eine Sitzung über mehrere Aufgaben hinweg bei.
Kasada-Header generieren
$1.25 pro 1,000 · fehlgeschlagene Aufträge werden erstattet
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
}
}Eigenständiges Kasada unterstützt derzeit HTTPS-Ziele auf www.ticketmaster.com. Wenden Sie jeden zurückgegebenen Header sofort mit der zurückgegebenen Browseridentität und dem erfolgreichen Proxy an. Header-Sätze sind an Ziel, Identität und ausgehende Verbindung gebunden. Weisen Sie Kasada einem Platz im unbegrenzten Tarif zu, um diese Aufgaben in Ihren Tarif einzuschließen.
Ticketmaster TMPT generieren
$0.99 pro 1,000 · fehlgeschlagene Aufträge werden erstattet
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
}Die Ticketmaster-URL ist erforderlich, die Anfrage-ID nicht. Verwenden Sie action Event mit der genauen Event-URL und Login mit der Einstiegs-URL zur Anmeldung. Die TMPT-Erstellung wartet standardmäßig bis zu 1.5 Sekunden, damit eine bereits verfügbare Lösung direkt zurückgegeben werden kann; neue Arbeit fällt auf eine ausstehende Aufgabe zurück. Setzen Sie den URL-Abfrageparameter waitMs=0 für eine vollständig asynchrone Erstellung oder bis zu waitMs=75000 für eine längere begrenzte Wartezeit. Prüfen Sie anschließend den Aufgabenstatus und fragen Sie ihn wiederholt ab, wenn er noch nicht endgültig ist. Das Token ist der rohe Wert des Cookies tmpt. Weisen Sie Ticketmaster TMPT einem Platz im unbegrenzten Tarif zu, um diese Aufgaben in Ihren Tarif einzuschließen.
Asynchroner Fallback
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
}Die meisten Integrationen benötigen diese Anfrage nie. Verwenden Sie sie nur, wenn die Erstellungsantwort nach ihrem synchronen Zeitfenster weiterhin pending oder solving ist, oder um eine idempotente Aufgabe nach einer Verbindungsunterbrechung wieder abzurufen. Kasada wartet bis zu 75 Sekunden und reCAPTCHA verwendet 15 Sekunden. TMPT wartet standardmäßig bis zu 1.5 Sekunden; verwenden Sie waitMs=0 für eine vollständig asynchrone Erstellung oder einen expliziten TMPT-Wert waitMs von bis zu 75 Sekunden.
Fehler behandeln
status · failed
{
"id": "login_20260910_0001",
"status": "failed",
"errorCode": "site-unreachable",
"error": "target page did not respond",
"durationMs": 9210
}Identität enthalten
Das Token wird mit den Werten userAgent und secChUa geliefert, für die es ausgestellt wurde. Senden Sie diese zusammen.
Fehlgeschlagene Lösungen sind kostenlos
Eine Aufgabe, die mit failed endet, wird Ihrem Guthaben automatisch erstattet.
Geheime Daten geschützt
Token, Cookies, Proxys und Fingerprints erscheinen weder in Aufgabenlisten noch in Protokollen.