概述:
穿云 API 致力于为开发者提供极速绕过 Cloudflare 验证的解决方案。目前已全面支持绕过 WAF 防护、Turnstile CAPTCHA 以及 5 秒盾(JS Challenge)。
本文档详细说明了如何通过 Go 语言集成穿云 HTTP API。通过模拟 JA3 指纹与 HTTP/2 全栈环境,您可以像访问普通接口一样访问受保护的目标网站。
发起请求:V2 核心逻辑
穿云 API 采用标准的 HTTPS 协议,支持所有 HTTP 请求方法。在 V2 架构下,系统引入了更智能的会话保持与指纹对齐机制。
1. 基础请求地址:https://api.cloudbypass.com
2. 必选请求头参数:
| 参数名 | 描述 | 备注 |
|---|---|---|
x-cb-apikey | 您的 API 密钥 | 从控制台获取 |
x-cb-host | 目标服务器主机名 | 如访问 example.com/path,则填 example.com |
x-cb-proxy | 固定或具时效性的代理 | V2 必须配置,用于对齐会话环境 |
x-cb-part | 会话分区 ID | 可选。用于多并发下的会话隔离与独立存储 |
3. V1 与 V2 逻辑区别:
- V1 模式: 每次请求均为无状态,主要依靠指纹库直接突破。
- V2 模式(推荐): 必须提供
x-cb-proxy代理地址。当遇到 Cloudflare 挑战时,穿云将自动完成人机验证。挑战成功后,系统会为该分区/代理自动存储会话 10 分钟。后续请求将复用该成功会话,并在成功访问后自动续期,极大提升了采集效率。
Go 代码实现示例
以下是基于 Go 标准库实现的 V2 接口请求模板。该示例已针对最新的 V2 异步挑战逻辑 进行了结构规范化。
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
// 目标 URL 路径(除域名外的部分)
reqUrl := "https://api.cloudbypass.com/api/v2/example-path"
req, _ := http.NewRequest("GET", reqUrl, nil)
// 配置穿云 V2 核心请求头
req.Header.Set("x-cb-apikey", "您的API_KEY")
req.Header.Set("x-cb-host", "www.target-website.com")
// V2 必须设置代理,格式为 http://user:pass@host:port
req.Header.Set("x-cb-proxy", "http://your-proxy-address:port")
// 可选:设置会话分区以隔离不同任务的会话
req.Header.Set("x-cb-part", "session_001")
// 发起请求
resp, err := client.Do(req)
if err != nil {
fmt.Printf("请求异常: %v\n", err)
return
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println("响应内容:", string(body))
}
快速联调与资源
- 代码生成器:支持一键生成完整 Go 脚本,直接复制即可运行。
👉 立即使用:穿云 API 代码生成器 - 完整文档:更多关于响应码处理与多语言 SDK 的详细内容,请参考官方快速开始手册。
👉 查看 Go 快速接入文档