Sua primeira resolução
Gere um token, conjunto de cabeçalhos ou cookie em uma única requisição e envie-o com a identidade para a qual foi emitido.
início rápido
URL base
https://api.solvethree.com/v1
autenticação
Authorization: Bearer <key>
Referência completa de integração em Markdown.
Gerar um 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
}A requisição de criação aguarda até 15 segundos e normalmente retorna o token pronto. O site deve ter um perfil ativo neste espaço de trabalho. Um site atribuído ao seu plano ilimitado está incluído; qualquer outro site reserva um crédito de pagamento por uso.
Campos opcionais (proxy ou proxyCandidates é obrigatório)
- recaptchaType
- Use "v3" para v3 padrão. Omita para usar o padrão "enterprise-v3", compatível com versões anteriores.
- requestId
- Sua própria chave de idempotência, de 1–64 caracteres. Reenviá-la retorna a mesma tarefa.
- proxyCandidates
- Até seis proxies HTTP(S) distintos. solution.egressAttempts é o índice do candidato vencedor, começando em 1. As sessões exigem um único proxy.
- userAgent, secChUa
- Fixe a identidade do navegador que você usará com o token.
- timezoneOffsetMinutes
- Use o mesmo fuso horário do cliente que envia o token.
- session
- Mantenha uma sessão entre tarefas para fluxos com várias etapas.
Gerar cabeçalhos Kasada
$1.25 por 1,000 · tarefas com falha reembolsadas
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
}
}O Kasada independente atualmente oferece suporte a destinos HTTPS em www.ticketmaster.com. Aplique imediatamente todos os cabeçalhos retornados com a identidade de navegador retornada e o proxy bem-sucedido. Os conjuntos de cabeçalhos estão vinculados ao destino, à identidade e à saída de rede. Atribua o Kasada a uma vaga do plano ilimitado para incluir essas tarefas no seu plano.
Gerar Ticketmaster TMPT
$0.99 por 1,000 · tarefas com falha reembolsadas
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
}A URL do Ticketmaster é obrigatória; o ID da requisição não. Use a ação Event com a URL exata do evento e Login com a URL de entrada do login. A criação de TMPT aguarda até 1.5 segundos por padrão para que uma resolução pronta possa retornar diretamente; um novo processamento retorna uma tarefa pendente como alternativa. Defina o parâmetro de consulta da URL waitMs=0 para uma criação totalmente assíncrona ou até waitMs=75000 para uma espera limitada mais longa, depois inspecione o status da tarefa e consulte periodicamente se ela permanecer em um estado não terminal. O token é o valor bruto do cookie tmpt. Atribua o Ticketmaster TMPT a uma vaga do plano ilimitado para incluir essas tarefas no seu plano.
Alternativa assí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
}A maioria das integrações nunca precisa desta requisição. Use-a apenas se a resposta de criação permanecer em pending ou solving após sua janela síncrona, ou para recuperar uma tarefa idempotente após uma interrupção de conexão. O Kasada aguarda até 75 segundos e o reCAPTCHA usa 15 segundos. O TMPT aguarda até 1.5 segundos por padrão; use waitMs=0 para criação totalmente assíncrona ou um waitMs explícito de TMPT de até 75 segundos.
Tratar falhas
status · failed
{
"id": "login_20260910_0001",
"status": "failed",
"errorCode": "site-unreachable",
"error": "target page did not respond",
"durationMs": 9210
}Identidade incluída
O token vem com o userAgent e o secChUa para os quais foi emitido. Envie-os juntos.
Resoluções com falha são gratuitas
Uma tarefa que termina em failed é reembolsada automaticamente no seu saldo.
Segredos protegidos
Tokens, cookies, proxies e fingerprints ficam fora das listagens de tarefas e dos registros.