设置 reCAPTCHA 站点配置

1. 1.

   检查工作区

   请在创建任务时所用 API 密钥所属的工作区中设置配置。其他工作区中的配置无法满足要求。如果控制台显示“充值以继续”，请先按提示操作，再继续设置。

2. 2.

   打开“添加网站”

   在“网站配置”中选择“添加网站”。在“页面 URL”中输入目标 HTTPS 页面。在“reCAPTCHA 类型”下，选择与页面匹配的 Enterprise v3 或普通 v3。

3. 3.

   设置采集参数

   “采集操作”为必填项。请使用你打算求解的操作；如果不确定，请先查找 reCAPTCHA 操作。表单还提供可选的“导航 URL”“网站密钥”和“Referer 值”字段。网站密钥可自动发现。

4. 4.

   提交表单

   选择“添加网站”。已审核的系统配置无需实时拉取即可填入已知的页面契约和采集操作；表单会说明所选操作。其他提交可能进入排队中、采集中、验证中或审核中状态。

检查生成的配置的状态。ACTIVE 会显示为 active，这是求解所需的状态。如果采集失败，控制台会显示原因并允许重试。

此任务请求体使用配置中的主机名和操作：

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• site 是“页面 URL”中的主机名，不含协议或路径。
• action 是受保护请求所用的操作。请确保与要使用的配置匹配。
• recaptchaType 默认为 enterprise-v3。对于普通 v3 配置，请显式设置为 v3。
• 将代理占位符替换为 HTTP(S) 代理，目标请求也必须使用同一代理。

Python 快速入门和 Node.js 快速入门介绍了如何发送请求并使用结果。

任务没有可用配置。

核对 API 密钥所属的工作区及任务的主机名，确认它们与你设置的配置一致。

试试这样做： 在将要创建任务的工作区中添加目标网站配置。重复创建任务不会补建缺失的配置。

配置处于排队中、采集中、验证中或审核中状态。

在“网站配置”中查看其当前状态。

试试这样做： 请等待配置激活后再请求求解。这些状态不能替代已激活状态。

采集失败。

查看控制台显示的失败原因。

试试这样做： 修正该原因指出的问题，然后重试采集。

配置已激活，但目标操作仍无法匹配到配置。

核对主机名、采集操作和 reCAPTCHA 类型。如果执行操作不同，请检查是否存在唯一明确的采集目标。

试试这样做： 请设置与目标主机名、操作和类型匹配的配置，不要仅为选中现有配置而将任务改成无关操作。