为什么 solvethree 使用站点配置,而不是 websiteKey 字段
solvethree 将 reCAPTCHA 站点密钥和页面设置保存在站点配置中。任务请求通过 site 提供主机名,通过 action 提供执行操作,并提供代理,而不是 websiteKey 或 websiteURL。
如果你正从其他 API 迁移,这不只是重命名字段。请先在工作区中设置活跃配置;发送主机名、操作或站点密钥不会创建配置。
本页内容
在控制台中配置站点密钥和页面
- 1.
打开“添加网站”
前往站点配置,选择“添加站点”。输入目标的 HTTPS 页面 URL。任务将使用其中的主机名,而非完整 URL。如页面设置需要,可提供可选的导航 URL 和 Referer 值。
- 2.
选择类型并检查站点密钥
对于 reCAPTCHA Enterprise 集成,选择 Enterprise v3;对于常规 reCAPTCHA v3,选择 Regular v3。表单可以自动发现站点密钥;你也可以在可选的“站点密钥”字段中提供覆盖值。
- 3.
设置捕获操作
捕获操作为必填项。对于下方请求,请配置一个捕获操作为
login的配置。经过审核的系统配置可直接填入已知的页面设置和捕获操作,无需实时抓取;请阅读表单中对所选操作的说明。 - 4.
提交并等待配置激活
选择“添加站点”。提交后,配置可能会经历排队、捕获、验证或审核状态,然后才会激活;捕获时长没有保证。某些账户会显示“充值以继续”。如果捕获失败,请先检查原因,再重试。
每个主机名、捕获操作和 reCAPTCHA 类型的组合使用一个配置。执行操作完全匹配时,会选用对应配置。其他执行操作要求捕获目标唯一且明确,因此不要认为某个主机名下的单个配置能覆盖所有操作。
发送扁平结构任务请求
配置激活后,将此对象直接作为 JSON 请求体发送到 POST /v1/tasks。使用 Authorization: Bearer 后接工作区 API 密钥进行身份验证,并将该密钥保存在服务端。
{
"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 工作区额度开始体验。