API 连接与 CAPTCHA 代理并不相同

Application server
  -> HTTPS api.solvethree.com/v1/tasks
     Authorization: Bearer <workspace API key>
     JSON: { "site": "accounts.example.com", "action": "login", "proxy": "http://USER:PASS@PROXY:PORT" }

solvethree solves through the proxy supplied in that JSON.

Application or browser
  -> the SAME successful proxy and pinned exit
  -> intended target, with the returned token/headers/cookie and browser identity

The API key belongs on the API request, never the target request.
Putting a proxy URL in task JSON does not configure the application's HTTP client.

服务器向 solvethree API 发送经过身份验证的 HTTPS 请求。代理 URL 包含在 JSON 请求体中；随后 solvethree 使用该代理进行求解。之后，应用程序或浏览器向目标网站发起独立请求。任务字段和 SDK 调用都不会自动配置最后这条连接。

将示例主机名、操作和代理凭据替换为你自己的值。该站点需要有工作区可用的有效配置文件；发送主机名并不会创建配置文件。请参阅站点配置文件设置。

将工作区 API 密钥保留在服务器上。仅向 API 主机发送其 Bearer 授权标头，获取任务状态时也不例外。不要将该标头复制到目标请求中，也不要将其用于代理身份验证。

单独配置提交解决方案的 HTTP 客户端或浏览器。将成功的代理与返回的 userAgent 和 secChUa 浏览器身份配合使用。不要将解决方案与无关的浏览器身份、代理或目标 URL 混用。

如果提供商会在不同连接之间轮换出口 IP，仅使用相同的代理 URL 并不够。请使用提供商的会话或固定出口功能，让求解和目标提交共用同一出口。住宅或移动代理标签并不能证明目标网站会接受它。

如果使用 proxyCandidates，请通过实际成功的代理提交，而不是任意选择列表中的一项。候选项让 solvethree 可以尝试其他出口；它们不会配置浏览器，也不保证目标网站会接受。

任务状态为 ready 表示已有可用的解决方案。是否被接受是另一项结果：请检查目标网站对携带该解决方案的请求所返回的响应。

如果 HTTP 客户端会读取 HTTP_PROXY 或其他代理环境设置，请检查这些设置是否也会将发往 api.solvethree.com 的请求路由到代理。这可能会让 API 连接经过原本仅用于目标流量的代理。请检查客户端实际生效的传输配置，不要假定它与任务 JSON 一致。

分别配置 API 传输和目标传输。环境代理设置不能替代必需的任务字段：reCAPTCHA 请求仍须提供 proxy 或 proxyCandidates，且只能提供其中一个。

API 请求在收到任务之前失败。

检查 HTTP 响应以及 API 客户端使用的路由，包括所有代理环境设置。

试试这样做： 先处理 HTTP 错误，再读取成功响应载荷。请纠正非预期的 API 路由，而不是盲目更改任务代理。

收到 HTTP 407。

确定哪条连接遇到了代理身份验证失败：是 API 连接，还是使用任务代理的连接。

试试这样做： 修正该代理的凭据。对用户名和密码组成部分中的保留字符进行百分号编码，而不是对整个 URL 编码。

任务创建超时。

超时不能证明 API 未能创建任务。

试试这样做： 如果已有任务 ID，请获取该任务。如果提供了 requestId，请在创建新的逻辑任务之前，使用该 ID 重复相同的任务请求以找回原任务。

任务进入 failed 状态。

读取其 errorCode 和 error；这与 HTTP 传输错误不同。

试试这样做： 停止轮询该任务，并解决所报告的原因。不要原样重试无效输入，也不要假定失败是由 API 连接的代理导致的。