Tu primera solución
Genera un token, un conjunto de cabeceras o una cookie en una sola solicitud y envíalo con la identidad para la que se emitió.
inicio rápido
URL base
https://api.solvethree.com/v1
autenticación
Authorization: Bearer <key>
Referencia completa de integración en Markdown.
Generar un token
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 solicitud de creación espera hasta 15 segundos y normalmente devuelve el token terminado. El sitio debe tener un perfil activo en este espacio de trabajo. Los sitios asignados a tu plan ilimitado están incluidos; cualquier otro sitio reserva un crédito de pago por uso.
Campos opcionales (se requiere proxy o proxyCandidates)
- recaptchaType
- Usa "v3" para v3 estándar. Omítelo para usar el valor predeterminado "enterprise-v3", compatible con versiones anteriores.
- requestId
- Tu propia clave de idempotencia, de 1–64 caracteres. Volver a enviarla devuelve la misma tarea.
- proxyCandidates
- Hasta seis proxies HTTP(S) distintos. solution.egressAttempts es el índice del candidato ganador, empezando por uno. Las sesiones requieren un único proxy.
- userAgent, secChUa
- Fija la identidad del navegador que usarás con el token.
- timezoneOffsetMinutes
- Utiliza la misma zona horaria que el cliente que envía el token.
- session
- Mantén una sesión entre tareas para flujos de varios pasos.
Generar cabeceras de Kasada
$1.25 por 1,000 · reembolso de trabajos fallidos
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 independiente admite actualmente destinos HTTPS en www.ticketmaster.com. Aplica de inmediato todas las cabeceras devueltas con la identidad de navegador devuelta y el proxy que funcionó. Los conjuntos de cabeceras están vinculados al destino, la identidad y la salida de red. Asigna Kasada a una plaza del plan ilimitado para incluir estas tareas en tu plan.
Generar Ticketmaster TMPT
$0.99 por 1,000 · reembolso de trabajos fallidos
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
}La URL de Ticketmaster es obligatoria; el ID de solicitud no. Usa la acción Event con la URL exacta del evento y Login con la URL de entrada al inicio de sesión. La creación de TMPT espera hasta 1.5 segundos de forma predeterminada para que una resolución en caliente pueda devolverse directamente; el trabajo nuevo pasa a una tarea pendiente. Establece el parámetro de consulta de URL waitMs=0 para una creación totalmente asíncrona o hasta waitMs=75000 para una espera limitada más larga; después, comprueba el estado de la tarea y consulta periódicamente si sigue en un estado no terminal. El token es el valor sin procesar de la cookie tmpt. Asigna Ticketmaster TMPT a una plaza del plan ilimitado para incluir estas tareas en tu plan.
Alternativa asíncrona
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 mayoría de las integraciones nunca necesitan esta solicitud. Úsala solo si la respuesta de creación sigue en pending o solving tras su ventana síncrona, o para recuperar una tarea idempotente después de una interrupción de la conexión. Kasada espera hasta 75 segundos y reCAPTCHA utiliza 15 segundos. TMPT espera hasta 1.5 segundos de forma predeterminada; usa waitMs=0 para una creación totalmente asíncrona o un valor explícito de waitMs para TMPT de hasta 75 segundos.
Gestionar fallos
status · failed
{
"id": "login_20260910_0001",
"status": "failed",
"errorCode": "site-unreachable",
"error": "target page did not respond",
"durationMs": 9210
}Identidad incluida
El token se entrega con los valores userAgent y secChUa para los que se emitió. Envíalos juntos.
Las resoluciones fallidas son gratis
Una tarea que termina en failed se reembolsa automáticamente a tu saldo.
Secretos protegidos
Los tokens, las cookies, los proxies y las huellas digitales no se incluyen en las listas de tareas ni en los registros.