Votre première résolution
Générez un jeton, un ensemble d’en-têtes ou un cookie en une seule requête et soumettez-le avec l’identité pour laquelle il a été émis.
démarrage rapide
URL de base
https://api.solvethree.com/v1
authentification
Authorization: Bearer <key>
Référence d’intégration complète en Markdown.
Générer un jeton
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
}La requête de création attend jusqu’à 15 secondes et renvoie normalement le jeton final. Le site doit disposer d’un profil actif dans cet espace de travail. Un site attribué à votre forfait illimité est inclus ; tout autre site réserve un crédit de paiement à l’usage.
Champs facultatifs (proxy ou proxyCandidates est requis)
- recaptchaType
- Utilisez "v3" pour la version v3 standard. Omettez ce champ pour utiliser la valeur par défaut rétrocompatible "enterprise-v3".
- requestId
- Votre propre clé d’idempotence, de 1 à 64 caractères. La renvoyer retourne la même tâche.
- proxyCandidates
- Jusqu’à six proxys HTTP(S) distincts. solution.egressAttempts est l’indice du candidat retenu, à partir de 1. Les sessions nécessitent un seul proxy.
- userAgent, secChUa
- Fixez l’identité du navigateur que vous utiliserez avec le jeton.
- timezoneOffsetMinutes
- Utilisez le même fuseau horaire que le client qui soumet le jeton.
- session
- Conservez une session entre les tâches pour les parcours en plusieurs étapes.
Générer des en-têtes Kasada
$1.25 pour 1,000 · tâches échouées remboursées
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 autonome prend actuellement en charge les cibles HTTPS sur www.ticketmaster.com. Appliquez immédiatement chaque en-tête renvoyé avec l’identité de navigateur renvoyée et le proxy ayant réussi. Les ensembles d’en-têtes sont liés à la cible, à l’identité et à la sortie réseau. Attribuez Kasada à un emplacement du forfait illimité pour inclure ces tâches dans votre forfait.
Générer Ticketmaster TMPT
$0.99 pour 1,000 · tâches échouées remboursées
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
}L’URL Ticketmaster est obligatoire ; l’identifiant de requête ne l’est pas. Utilisez l’action Event avec l’URL exacte de l’événement et Login avec l’URL d’entrée de connexion. La création TMPT attend jusqu’à 1.5 seconde par défaut afin qu’une résolution à chaud puisse être renvoyée directement ; un nouveau traitement bascule vers une tâche en attente. Définissez le paramètre de requête d’URL waitMs=0 pour une création entièrement asynchrone, ou jusqu’à waitMs=75000 pour une attente bornée plus longue, puis inspectez le statut de la tâche et interrogez-le périodiquement s’il reste non terminal. Le jeton est la valeur brute du cookie tmpt. Attribuez Ticketmaster TMPT à un emplacement du forfait illimité pour inclure ces tâches dans votre forfait.
Repli asynchrone
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
}La plupart des intégrations n’ont jamais besoin de cette requête. Utilisez-la uniquement si la réponse de création reste au statut pending ou solving après sa fenêtre synchrone, ou pour récupérer une tâche idempotente après une interruption de connexion. Kasada attend jusqu’à 75 secondes et reCAPTCHA utilise 15 secondes. TMPT attend jusqu’à 1.5 seconde par défaut ; utilisez waitMs=0 pour une création entièrement asynchrone ou une valeur TMPT waitMs explicite allant jusqu’à 75 secondes.
Gérer les échecs
status · failed
{
"id": "login_20260910_0001",
"status": "failed",
"errorCode": "site-unreachable",
"error": "target page did not respond",
"durationMs": 9210
}Identité incluse
Le jeton est fourni avec les valeurs userAgent et secChUa pour lesquelles il a été émis. Envoyez-les ensemble.
Les résolutions échouées sont gratuites
Une tâche qui se termine avec le statut failed est automatiquement remboursée sur votre solde.
Secrets protégés
Les jetons, cookies, proxys et empreintes ne figurent ni dans les listes de tâches ni dans les journaux.