穿云 cURL API 开发文档

概述:
穿云 API 致力于帮助开发者轻松绕过 Cloudflare 的高级防御体系,目前已全面支持绕过 WAF 防护5 秒盾(JS Challenge)Turnstile 人机验证

本文档详细介绍了穿云 HTTP API 的 V2 核心逻辑,包括接口地址、请求头参数及会话保持机制,确保您的采集任务拥有最高的稳定性和指纹拟真度。


1. 基础请求信息

穿云 API 采用标准的 HTTPS 协议,兼容所有主流 HTTP 请求方法。

  • API 请求地址https://api.cloudbypass.com
  • 接入逻辑:您需要将目标请求的协议和主机名替换为穿云 API 地址,并通过 自定义请求头(Custom Headers) 传递目标信息。

2. 核心请求头参数 (V2 标准)

为了确保请求能够成功模拟 JA3 指纹HTTP/2 特征,请在请求中包含以下参数:

参数名是否必选说明
x-cb-apikey您的 API 密钥,可在穿云后台获取。
x-cb-host目标服务器的主机名(Domain)。例如访问 https://www.example.com/path,则填入 www.example.com
x-cb-proxyV2 强制项。必须设置固定或具有时效性的海外代理服务器地址。格式:http://user:pass@host:port
x-cb-part会话分区参数。用于实现会话隔离,确保不同任务之间的 Cookie 和缓存不冲突。

3. V1 与 V2 逻辑差异说明

  • V1 版本(无状态):请求之间相互独立,支持默认代理,适用于简单的静态页面抓取。
  • V2 版本(有状态/自动化)
    • 核心机制:必须提供有效的 IP 代理。当系统检测到 Cloudflare JS 质询时,会自动进行后台挑战。
    • 会话保持:挑战成功后,穿云将存储该 Cloudflare 会话 10 分钟。后续带有相同代理或分区的请求将自动复用该会话,无需重复挑战,请求成功后会话将自动续期

4. 快速测试工具

建议使用穿云代码生成器一键生成符合 V2 标准的 cURL 命令或各语言(Python/Node.js/Go)集成代码:

👉 立即使用:穿云 API 代码生成器


详细文档参考:
如需查看完整的参数列表(如 User-Agent 锁定、Referer 设置等),请访问官方帮助中心:
https://docs.cloudbypass.com/#/zh-cn/quickstart