您的第一个解答结果
通过一次请求生成令牌、请求头集合或 Cookie,并使用签发时对应的身份信息一起提交。
快速入门
基础 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 秒,通常会返回已生成的令牌。该站点必须在此工作区中具有已启用的配置。已分配至无限量套餐的站点包含在套餐内;其他站点每次会预留一份按量付费额度。
可选字段(proxy 或 proxyCandidates 必填其一)
- recaptchaType
- 常规 v3 请使用 "v3"。省略该值则使用向后兼容的默认值 "enterprise-v3"。
- requestId
- 您自定义的幂等键,长度为 1–64 个字符。重新发送该键会返回同一任务。
- proxyCandidates
- 最多支持六个不同的 HTTP(S) 代理。solution.egressAttempts 是成功候选代理从 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 则不是。请将 action Event 与准确的活动 URL 配合使用,将 Login 与登录入口 URL 配合使用。TMPT 创建默认最多等待 1.5 秒,以便热求解直接返回;新任务则回退为待处理任务。将 URL 查询参数设为 waitMs=0 可完全异步创建,或设为最高 waitMs=75000 以延长有界等待时间,然后检查任务状态;如果仍未进入终态,则进行轮询。令牌是原始的 tmpt Cookie 值。将 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 的任务,其费用会自动退回您的余额。
敏感信息保护
令牌、Cookie、代理和指纹不会出现在任务列表或日志中。