reCAPTCHA Enterprise v3 API

作者：solvethree 更新于

从后端获取 reCAPTCHA v3 Enterprise 令牌。只需配置一次网站，然后发送其主机名、操作和代理。我们会返回令牌，以及提交令牌时应使用的用户代理和客户端提示。

试用 API
本页内容

发起请求

首次解算前，请在工作区中设置并启用网站配置。在 site 中发送主机名，在 action 中发送页面实际使用的 reCAPTCHA 操作。默认使用 Enterprise v3；标准 v3 请使用 recaptchaType: v3。此任务不需要 type、完整页面 URL 或网站密钥。

通过 POST https://api.solvethree.com/v1/tasks 创建任务。在 Authorization: Bearer 请求头中提供工作区 API 密钥进行认证。

任务请求体 · 替换示例目标和代理
{
  "site": "example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example-recaptcha-001"
}

提交令牌

任务就绪后，读取 solution.token。使用返回的 userAgent 和 secChUa，通过同一代理将其提交到应用的 CAPTCHA 字段。在需要令牌的请求发出前再进行解算；不要缓存令牌供以后使用。

任务状态为 ready 表示已生成解算结果。请检查目标的响应，确认其是否接受了请求。

等待与超时

创建时默认最多等待 15 秒。如果希望立即获取任务 ID 并轮询任务，请使用 ?waitMs=0。

状态为 ready 或 failed 时停止。如果创建超时，请使用相同输入复用原始 requestId 来找回任务。新的 ID 可能会创建另一个计费解算任务。

价格

每 1,000 次求解 $2.00，从工作区余额中扣除。求解失败退款。初始可获 $5 欢迎额度；最低付费充值金额为 $10。

reCAPTCHA Enterprise v3 API · solvethree