FunCaptcha 任务
通过 createTask方法 创建识别任务,然后通过 getTaskResult 方法 获取识别结果
如果你获得了无效的token,请联系我们,通常在我们优化之后都可以正常工作
任务类型
任务类型 | 描述 | 价格 | 价格(美元) |
---|---|---|---|
FuncaptchaTaskProxyless | Funcaptcha 解决方案,使用服务器内置代理 | 12 POINTS | $1.2/1k |
创建任务
通过 createTask方法 创建识别任务
请求节点: https://api.ez-captcha.com
请求地址: https://api.ez-captcha.com/createTask
中国优化地址:http://47.115.166.118:15000/createTask
请求格式:POST
application/json
对象结构
属性 | 类型 | 必须 | 说明 |
---|---|---|---|
clientKey | string | 是 | 您账号的用户密钥 |
type | string | 是 | 任务类型: FuncaptchaTaskProxyless |
websiteURL | string | 是 | 使用Funcaptcha的网页地址,一般固定值。 |
websiteKey | string | 是 | 使用Funcaptcha网站密钥,固定值。 |
data | string | 否 | FunCaptcha 实现可能需要的附加参数。 使用此属性将“blob”值作为字符串化数组发送。 请参阅示例:
|
funcaptchaApiJSSubdomain | string | 否 | arkoselabs.com 的特殊子域,JS 验证码部件将从中加载。 大多数 FunCaptcha 都在共享域中运行。 |
proxy | string | 否 | 代理格式: 协议头:ip:端口:用户名:密码 如: "http:111.222.111.222:10103:用户名:密码" 请注意,解决FunCAPTCHA 时如果你使用的是动态代理, 你需要保证你的代理支持session (需要固定session id确保IP一致性). 否则我们将直接使用您提供的动态IP直接访问,可能会不匹配你所使用的ip, 从而导致token无效 |
cn | bool | 否 | 如果你的代理是中国区域代理,请设置为true,否则不用设置 如果你的代理商一定需要添加白名单,请把IP “202.105.112.236” 添加到白名单中 (该功能目前只支持中国区域代理) |
**注意
如果你的代理是中国区域代理,请设置为true,否则不用设置,如果你的代理商一定需要添加白名单,请把IP “202.105.112.236” 添加到白名单中 (该功能目前只支持中国区域代理)
请注意,解决FunCAPTCHA 时如果你使用的是动态代理, 你需要保证你的代理支持session (需要固定session id确保IP一致性). 否则我们将直接使用您提供的动态IP直接访问,可能会不匹配你所使用的ip, 从而导致token无效
请求示例
POST https://api.ez-captcha.com/createTask
Content-Type: application/json
{
"clientKey": "7e5ffc29e3354a19991002f2a19978bb696679",
"task": {
"websiteURL": "https://signup.live.com/signup2",
"websiteKey": "B7D8911C-5CC8-A9A3-35B0-554ACEE604DA",
"type": "FuncaptchaTaskProxyless",
"proxy": "http:111.222.111.222:10103:username:password",
"cn": true
}
}
请求示例(完整参数)
POST https://api.ez-captcha.com/createTask
Content-Type: application/json
{
"clientKey": "7e5ffc29e3354a19991002f2a19978bb696679",
"task": {
"websiteURL": "https://signup.live.com/signup2 ",
"websiteKey": "B7D8911C-5CC8-A9A3-35B0-554ACEE604DA",
"type": "FuncaptchaTaskProxyless",
"proxy": "http:111.222.111.222:10103:username:password",
"cn": true,
"data": "{\"blob\": \"zovhMwTRjCpfcVNl.I9rn5oNdZetyte0643eFqqSN3K8u+kdF/0VP9UCqRtUxAjg8ULXcPw8xyOSVWdm0LPfbSXgjWNgGjZjeE1wuiJvhG9BPGIZkXMQQhA8mYf9E8X6WdvyscLq53RNPO2575GJ86nUOOQOAgjTmLI9NPpPfBaBwRVqaYxFVtp03H+fEDgsqvc6Jy2pviPMHi/5v2jE46AoM0GG+4qjGD+jUZaibttCxTiYnWzYmnHG1bp2SiFVDArttDciqcBC2st9eeNioC0D7Ym0ONt2dCJk6LIQaLlqg1ieTEw9t4Y6lQsfUzH/bMNjOPapqYVmH0IuVSt/v8uPu5zqIZ/8OweXEU92b2BBzEXw6IK11Y0cwLZWldPIx1B1NqajlG3LfMEoe8Y3dayXKkASymacvX6tXKKkeZDUs8Zz7SZ4OldU5hdNn7RVsomMseG2l2pGzmVTXSFL8s2EavAl7GTTKDdzSX1qeBDHVbfQ3/9vkKwGdQ5J3+tQjtw1fP00c1AL5/fMIL+Io9odEyaOgqnK0pdg7UN+67LUcIo8T86F76nn9Pqjle5hywsZjmaKJALg2Sd7pA+l1e64/HrW7AdT+ZTfM7Q2Oc/Et/6hY6eOZiG21Ny3CSg==\"}"
}
}
响应示例
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // 请记录此ID
}
获取结果
使用 getTaskResult 方法获取识别结果
请求节点: https://api.ez-captcha.com
请求地址: https://api.ez-captcha.com/getTaskResult
中国优化地址:http://47.115.166.118:15000/getTaskResult
请求格式:POST
application/json
根据系统负载,您将在大约 10s 到 20s 的时间间隔内得到结果
请求示例
响应结果
参数 | 类型 | 说明 |
---|---|---|
errorId | Integer | 错误提示: 0 - 没有错误,1 - 有错误 |
errorCode | string | 错误代码, 点这里查看全部错误列表 |
errorDescription | string | 错误详细描述 |
status | String | processing - 正在识别中,请1秒后重试 |
solution | Object | 识别结果,不同类型的captcha的结果会有所区别,对于Funcaptcha而言,结果为对象中的token。 |
solution.token | string | 识别结果:token值,用于POST或模拟提交给目标网站。 一次性使用,建议获取后立即使用。 |
响应示例
响应说明
识别成功:当
errorId
等于0
并且status
等于ready
,结果在solution
里面。正在识别中:当
errorId
等于0
并且status
等于processing
,请1秒后重试。出错了:当
errorId
大于0
,请根据errorDescription
了解出错误信息 全部错误说明