CloudFlareTask: CloudFlare5S
- YesCaptcha ADMIN
Create a recognition task through the use of the "createTask" method, and subsequently retrieve the recognition results by employing the "getTaskResult" method.
Initiating the task
Create a recognition task by utilizing the "createTask" method.
Request node： INTERNATIONAL NODE https://api.yescaptcha.com DOMESTIC NODE https://cn.yescaptcha.com
Request address： https://api.yescaptcha.com/getBalance
Request format：POST application/json
Object structure
Attributes | Type | Required | Description |
|---|---|---|---|
type | string | Yes | CloudFlareTaskS2 25 POINTS updated 20241218 |
websiteURL | string | Yes | 网页地址，需要识别的地址。 |
userAgent | string | No | 自定义Ua值 仅CloudFlareTaskS2类型支持 |
waitLoad | Bool | No | 是否必须等待页面加载完成（如果你需要完整内容） |
requiredCookies | List | No | 可以要求获取指定Cookies名称，默认为 可以指定多个，但不是一定能获取到 |
blockImage | Bool | No | 是否关闭图片加载，用于节省流量 |
proxy | String | Yes | 代理地址，支持以下格式：
注意：如果需要权限，请将以下地址加入白名单：
注意：CF盾对代理要求较高，请使用国际代理，如果报ERROR_CAPTCHA_UNSOLVABLE错误，请更换代理再试一下，也可以联系我们测试是否能过（绝大部份情况都能过） 注意：不要使用本地代理（127.0.0.1、localhost、192.168.x.x、172.0.x.x），本地代理只有你自己电脑才能访问，服务器访问不了！ |
postData | Dict | No | 如果添加此字段，请求将会以Post的方式发送，如： {
"name": "hi"
} |
Request Example
{
"clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618f",
"task": {
"type": "CloudFlareTaskS2",
"websiteURL": "https://nowsecure.in",
"proxy": "http://JN3wWChA:Dsg7ckfv@45.91.239.47:62930", //请用你自己的代理，这个只是演示
"waitLoad": false, // 是否需要等待加载完成（如果你需要完整内容就写true，会增加识别时间）
"requiredCookies": ["cf_clearance"] // 可以要求获取指定Cookies名称，可不填，不一定能获取到
}
}Response Example
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // 请记录此ID
}Get the Result
To obtain the recognition result using the getTaskResult method.
Request node： INTERNATIONAL NODE https://api.yescaptcha.com CHINA NODE https://cn.yescaptcha.com
Request address： https://api.yescaptcha.com/getTaskResult
Request format：POST application/json
Based on the system load, you will receive the result within a time interval of 10s to 80s, with a timeout of 120 seconds.
Request Example
Response Result
Parameters | Type | Purpose |
|---|---|---|
errorId | Integer | 错误提示： 0 - 没有错误，1 - 有错误 |
errorCode | string | 错误代码，点这里查看全部错误列表 |
errorDescription | string | 错误详细描述 |
status | String | processing - 正在识别中，请3秒后重试 |
solution | Object | 识别结果，不同类型的任务结果会有所区别。 |
user_agent | string | 使用的ua值，请使用返回的值进行后续请求 |
cookies | Object | 返回的cookies值，请使用返回的值进行后续请求， 一般cloudflare5s盾的cookies包含 这个cookie值有一定的有效期，有的网站长达1小时 所以1小时内不需要重复请求，但是也需要注意请求的频率 |
request_headers | Object | 请求时的headers，建议你在使用时带上这个值 放到你的请求的headers中！ |
headers | Object | 请求成功后响应的headers |
content | string | 返回的网页内容源码 |
Response Example
响应说明
请使用返回的ua值、cookie值以及创建任务的代理ip进行后续操作，因为cloudflare要求三者一致
请先确认是否为5s盾，判断方法：源码中包含
?__cf_chl_rt_tk字符串的为5s盾Please confirm whether the shield is 5s, judge method: the source code contains? The string is 5s shield
如果不是5s盾，但是使用requests等工具请求的时候标题出现：
Just a moment...或请稍后，并且响应码为403，则可能只是tls指纹拦截了，使用curl_cffi等库或者其他方法就可以绕过继续请求，真的5s盾使用正确的tls指纹也无法请求，如：https://nowsecure.nl网站。If it's not a 5s shield, but requests using tools such as. Or please wait, and the response code is 403, then it may just be the TLS fingerprint intercepted, using curl or other methods can bypass the continue request, the Real 5s shield using the correct TLS fingerprint can not request, https://nowsecure.nl websites.
通过本接口拿到结果后，在一定时间内有效（如1小时），可以不需要重复请求，但是要注意请求频率，频率过高可能会Cloudflare会封IP地址。
Once you get the result through this interface, it will be available for a certain period of time (say, 1 hour) , so you don't need to repeat the request, but be aware of the frequency of the request, which can cause Cloudflare to block the IP address.
接口还在内测中，有任何问题请联系客服对接技术沟通
Interface is still in the internal test, any problems please contact the customer service docking technology communication
如何判断5s盾：
关于指纹库
一部份网站只需要解决指纹问题，就不会弹验证码，也不需要使用接口
这里是模拟Chrome浏览器指纹，其他语言只要解决指纹问题就可以正常请求。
测试DEMO
