穿云API常见问题

Cloudflare 与 DataDome 共用同一套 API 积分，采用统一的积分消耗规则和定价策略。根据业务用量选择套餐；代理流量单独计费。

V1、V2(s) 每次请求成功后消耗 1 积分。

V2(s) 遇到并成功完成验证挑战时，额外消耗 2 积分。适用挑战包括 Cloudflare JS 质询、Cloudflare Turnstile、DataDome 和 Incapsula。

请求未成功时不扣基础请求积分；但验证挑战成功后会立即扣除 2 积分，即使后续响应出错，这部分挑战积分也不会返还。

复用有效会话可以减少重复挑战，但每次成功请求仍消耗 1 积分，并不是会话期间的后续请求免费。

积分需在套餐有效期内使用，过期后清空。不同套餐独立计算有效期，并优先消耗最早到期的积分。

通过标准 HTTP 请求，使用同一套接入逻辑和代码调用方式处理 Cloudflare 与 DataDome，保留现有采集框架。保持代理 IP、Cookie 与会话一致，并检查返回状态和内容。 是否支持具体目标仍取决于网站和验证类型，请先测试目标兼容性。统一套餐不代表所有目标都能成功访问。

Cloudflare 与 DataDome 共用相同的 API 接入逻辑和代码调用方式。

穿云API本身很简单，您只需要将发送到目标网站的http请求体发给我们，我们会将请求转发至 x-cb-host 指定的目标。
可以使用代码生成器，在线生成代码片段，用于cURL、JavaScript、TypeScript、Java、Python等命令发出HTTP请求。
穿云API和穿云代理IP 代码示例：点击查看

V2(s)版本能过js轮询(能渲染JS)；
目前V2(s)版本没有默认代理，需要再购买穿云代理IP，V1版本自带动态代理

会话分区用来区分管理cloudflare Cookie的，通过验证后会话生效。生效后代理IP、指纹等将持续10分钟无法更改，这是为了保证在会话期间内不会触发新的验证。至于账号会话需要自行管理。
从0-999，用户最多可以拥有1000个会话分区。第一次请求成功后会话分区将会锁定代理IP，可以通过修改会话分区值提交其它代理IP。会话锁定时长为十分钟，成功请求将刷新时长。

将请求地址输入代码生成器内测试，先用穿云V1测试；
如果V1过不去，就可以用穿云V2(s)版本测试，V2(s)需要自己配置IP，我们后台赠送了测试的IP代理流量，点击 穿云代理IP后台去提取下，提取IP建议设置10分钟以上的时效。

目前我们所有套餐的最大并发请求数是30次/s。

INSUFFICIENT_BALANCE 这个错误是你没有穿云API积分了。

你可以在穿云API后台购买：https://console.cloudbypass.com/#/api/login，或 联系客服：领取测试积分。

报错信息：
"code": "CHALLENGE_LOCK_OCCUPIED"
"message": "The current part is being challenged, please wait for the lock to be released."

错误说明：
出现 CHALLENGE_LOCK_OCCUPIED 说明代码可能存在以下问题：
同一 part 被多个线程同时使用。
多个用户使用同一账号并操作相同 part。
上一个请求占用了验证锁，可能因超时或人为中断尚未完成。

解决方案：
等待锁释放，稍后再尝试请求。
更换 part，可选范围为 0~999。

解决方案：
1、提取IP时设置10分钟时效。
2、换个国家地区的IP。（多提取点不同国家的IP轮询使用，只用同一个国家地区的IP容易被限制）

这种情况大概率是需要配置代理IP了，选择API模式和代理模式其中一种来使用我们的服务，国内用户推荐使用API模式，目前只支持http协议的代理IP。

目前不支持selenium和Puppeteer的浏览器自动化，因为没使用到浏览器，只是模拟浏览器请求。