您的第一个解答结果

通过一次请求生成令牌、请求头集合或 Cookie,并使用签发时对应的身份信息一起提交。

REST · v1

快速入门

  1. 01生成令牌
  2. 02生成 Kasada
  3. 03生成 TMPT
  4. 04异步回退
  5. 05处理失败

基础 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"
pending任务已接受,尚未被领取。
solving工作进程正在生成令牌。
ready令牌已在 solution 中提供。已计费。
failed请查看 errorCode。额度已退还。
{
  "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
}
401API 密钥无效
402额度不足
403站点配置未启用
409请求 ID 冲突
429超出速率限制 · retry-after: 60
502生成服务不可用 · 已退款
503生成服务已满载 · 已退款 · retry-after: 1

附带身份信息

令牌附带签发时对应的 userAgent 和 secChUa。请一起发送。

求解失败不收费

最终状态为 failed 的任务,其费用会自动退回您的余额。

敏感信息保护

令牌、Cookie、代理和指纹不会出现在任务列表或日志中。

API 文档 · solvethree