Friendly Captcha

查看全部价格

注意！

CapMonster Cloud 默认通过内置代理工作——这些代理已包含在费用内。仅当网站不接受令牌或对内置服务的访问受限时，才需要指定您自己的代理。

如果代理按 IP 授权，请将地址 65.21.190.34 加入白名单。

请求参数

type<string>required

CustomTask

class<string>required

friendly

websiteURL<string>required

包含验证码的页面完整 URL。

websiteKey<string>required

Friendly Captcha 密钥（请参阅章节如何查找 sitekey 值）。

apiGetLib (在 metadata 中)<string>required

JS 文件的链接。请根据验证码版本指定 JS 文件 URL：

V1: apiGetLib = https://cdn.jsdelivr.net/npm/[email protected]/widget.module.min.js，其中 X.Y.Z 是从 x-frc-client 响应头中获取的客户端版本。
V2: apiGetLib = 页面中加载的 site.min.js 文件 URL。

示例：https://cdn.jsdelivr.net/npm/@friendlycaptcha/[email protected]/site.min.js，其中 X.Y.Z 是客户端版本。

更多信息请参阅章节创建任务方法和如何识别 Friendly Captcha 版本。

userAgent<string>optional

浏览器的 User-Agent。
请仅传递来自 Windows 操作系统的最新 UA。目前为：userAgentPlaceholder

proxyType<string>required

http - 常规 HTTP/HTTPS 代理；
https - 当 http 不可用时使用（某些自定义代理必填）；
socks4 - SOCKS4 代理；
socks5 - SOCKS5 代理。

proxyAddress<string>required

代理 IP 地址（IPv4/IPv6）。禁止使用：

透明代理
本地机器代理

proxyPort<integer>required

代理端口

proxyLogin<string>required

代理登录名

proxyPassword<string>required

代理密码

创建任务方法

使用 metadata 中的 apiGetLib 参数值，应与 Friendly Captcha 的版本对应。

例如：

对于 V1

"apiGetLib": "https://cdn.jsdelivr.net/npm/[email protected]/widget.module.min.js"

对于 V2

"apiGetLib": "https://cdn.jsdelivr.net/npm/@friendlycaptcha/[email protected]/site.min.js"

CustomTask（无代理）
CustomTask（使用代理）

POST

https://api.capmonster.cloud/createTask

请求

{
  "clientKey": "API_KEY",
  "task": {
    "type": "CustomTask",
    "class": "friendly",
    "websiteKey": "FFMGEMAD2K3JJ35P",
    "websiteURL": "https://example.com",
    "userAgent": "userAgentPlaceholder",
    "metadata": {
  	"apiGetLib":"https://cdn.jsdelivr.net/npm/[email protected]/widget.module.min.js"
  }
}

响应

{
  "errorId": 0,
  "taskId": 407533077
}

POST

https://api.capmonster.cloud/createTask

请求

{
  "clientKey": "API_KEY",
  "task": {
    "type": "CustomTask",
    "class": "friendly",
    "websiteKey": "FFMGEMAD2K3JJ35P",
    "websiteURL": "https://example.com",
    "userAgent": "userAgentPlaceholder",
    "metadata": {
  	"apiGetLib":"https://cdn.jsdelivr.net/npm/[email protected]/widget.module.min.js"
  },
    "proxyType": "http",
    "proxyAddress": "8.8.8.8",
    "proxyPort": 8080,
    "proxyLogin": "proxyLoginHere",
    "proxyPassword": "proxyPasswordHere"
  }
}

响应

{
  "errorId": 0,
  "taskId": 407533077
}

获取任务结果方法

使用 getTaskResult 方法获取 Friendly Captcha 的解决结果。
响应中的令牌格式取决于网站上使用的验证码版本：

V1: "56a3727f1f9ae4f339c8e512913cd6f8.ac7W...MAKgAAAN+MAQArAAAAjxMBACwAAAB5QgAA.AgAB"

V2: "AQQA.8Q2TbgK_..._pknXDweJjKT2qwmroOhHcZsU4dHyu-jaGIPx9k7432p_num13buuTu6n4lVA=="

POST

https://api.capmonster.cloud/getTaskResult

请求

{
  "clientKey": "API_KEY",
  "taskId": 407533077
}

响应

{
  "errorId": 0,
  "errorCode": null,
  "errorDescription": null,
  "status": "ready",
  "solution": {
    "data": {
      "token": "56a3727f1f9ae4f339c8e512913cd6f8.ac7W...MAKgAAAN+MAQArAAAAjxMBACwAAAB5QgAA.AgAB"
    }
  }
}

获取到的 token 值需要填入对应字段：

版本	token 填充值字段
V1	`input.frc-captcha-solution`
V2	`input.frc-captcha-response`

如何查找 sitekey 值

对于 V1，可以在网络请求中通过关键词 sitekey 或 puzzle?sitekey= 进行过滤查找：

对于 V2，可以在网络请求或页面代码元素中搜索关键词 sitekey 或 data-sitekey：

如何识别 Friendly Captcha 版本

Friendly Captcha 主要有两种版本：V1 和 V2。可以通过加载的脚本或网络请求来判断版本。