为什么 solvethree 使用站点配置,而不是 websiteKey 字段

作者:solvethree阅读需 1 分钟

solvethree 将 reCAPTCHA 站点密钥和页面设置保存在站点配置中。任务请求通过 site 提供主机名,通过 action 提供执行操作,并提供代理,而不是 websiteKey 或 websiteURL。

如果你正从其他 API 迁移,这不只是重命名字段。请先在工作区中设置活跃配置;发送主机名、操作或站点密钥不会创建配置。

本页内容

在控制台中配置站点密钥和页面

  1. 1.

    打开“添加网站”

    前往站点配置,选择“添加站点”。输入目标的 HTTPS 页面 URL。任务将使用其中的主机名,而非完整 URL。如页面设置需要,可提供可选的导航 URL 和 Referer 值。

  2. 2.

    选择类型并检查站点密钥

    对于 reCAPTCHA Enterprise 集成,选择 Enterprise v3;对于常规 reCAPTCHA v3,选择 Regular v3。表单可以自动发现站点密钥;你也可以在可选的“站点密钥”字段中提供覆盖值。

  3. 3.

    设置捕获操作

    捕获操作为必填项。对于下方请求,请配置一个捕获操作为 login 的配置。经过审核的系统配置可直接填入已知的页面设置和捕获操作,无需实时抓取;请阅读表单中对所选操作的说明。

  4. 4.

    提交并等待配置激活

    选择“添加站点”。提交后,配置可能会经历排队、捕获、验证或审核状态,然后才会激活;捕获时长没有保证。某些账户会显示“充值以继续”。如果捕获失败,请先检查原因,再重试。

每个主机名、捕获操作和 reCAPTCHA 类型的组合使用一个配置。执行操作完全匹配时,会选用对应配置。其他执行操作要求捕获目标唯一且明确,因此不要认为某个主机名下的单个配置能覆盖所有操作。

发送扁平结构任务请求

配置激活后,将此对象直接作为 JSON 请求体发送到 POST /v1/tasks。使用 Authorization: Bearer 后接工作区 API 密钥进行身份验证,并将该密钥保存在服务端。

reCAPTCHA Enterprise · 请求结构
{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}
  • site 是主机名:不包含协议、路径或查询参数。完整的页面 URL 应填写在控制台的配置中。
  • action 是此任务的执行操作。这里的 login 与上面配置的捕获操作相匹配。
  • proxy 提供求解所用的代理。必须且只能提供 proxy 或 proxyCandidates 其中之一;不要同时发送两者。
  • requestId 为可选项。如果创建请求超时,使用相同 ID 重新发送相同请求会返回现有任务。复用该 ID 时更改任务输入会产生冲突。

不要沿用之前 API 请求结构中的 websiteKey、websiteURL、type 或 url。对于 reCAPTCHA,recaptchaType 默认为 enterprise-v3,因此示例中省略了该字段。常规 v3 需将 recaptchaType 设为 v3。

运行您的第一个任务。

使用 $5 工作区额度开始体验。

创建工作区
为什么 solvethree 使用站点配置,而不是 websiteKey 字段 · solvethree