첫 풀이 결과
요청 한 번으로 토큰, 헤더 세트 또는 쿠키를 생성하고 발급 시 사용된 식별 정보와 함께 제출하세요.
빠른 시작
기본 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초 동안 기다리며, 일반적으로 완성된 토큰을 반환합니다. 사이트에는 이 워크스페이스의 활성 프로필이 있어야 합니다. 무제한 요금제에 할당된 사이트는 요금제에 포함되며, 그 외 모든 사이트는 종량제 크레딧 1개를 예약합니다.
선택 필드(proxy 또는 proxyCandidates는 필수)
- recaptchaType
- 일반 v3에는 "v3"를 사용하세요. 이전 버전과 호환되는 기본값 "enterprise-v3"를 사용하려면 생략하세요.
- requestId
- 직접 지정하는 멱등성 키로, 길이는 1–64자입니다. 같은 키를 다시 보내면 동일한 작업을 반환합니다.
- proxyCandidates
- 서로 다른 HTTP(S) 프록시를 최대 6개 사용할 수 있습니다. solution.egressAttempts는 성공한 후보의 1부터 시작하는 인덱스입니다. 세션에는 프록시 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에는 action 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을 사용하거나 TMPT waitMs를 최대 75초로 명시하세요.
실패 처리
status · failed
{
"id": "login_20260910_0001",
"status": "failed",
"errorCode": "site-unreachable",
"error": "target page did not respond",
"durationMs": 9210
}식별 정보 포함
토큰에는 발급 시 사용된 userAgent와 secChUa가 함께 제공됩니다. 함께 전송하세요.
해결 실패 시 무료
failed 상태로 끝나는 작업은 잔액으로 자동 환불됩니다.
비밀 정보 보호
토큰, 쿠키, 프록시 및 핑거프린트는 작업 목록과 로그에 포함되지 않습니다.