概述：
穿云 API 为 Java 开发者提供了一套高效绕过 Cloudflare 验证的解决方案。通过集成穿云 API，您可以轻松突破 WAF 防护、Turnstile 人机验证以及 5 秒盾。本指南将帮助您快速对齐 V2 异步/同步接口逻辑，确保在 Java 环境下实现稳定的数据采集。

发起请求与核心配置

穿云 API 采用标准的 HTTPS 协议，支持所有 HTTP 方法。在 Java 中，您可以使用 OkHttp、Apache HttpClient 或 RestTemplate 进行集成。

请求基础地址： https://api.cloudbypass.com

必须配置的请求头（Header）：

• x-cb-apikey：您的 API 密钥。
• x-cb-host：目标服务器主机名（例如：www.example.com）。
• x-cb-proxy：（V2 核心要求） 必须设置固定或具有时效性的 IP 代理地址。穿云将基于该代理建立全栈环境。
• x-cb-part：（可选） 用于实现会话隔离。通过设置不同的分区 ID，可以在同一时间内管理多个独立的 Cloudflare 会话。

V1 与 V2 逻辑差异（必读）

• V1 逻辑（旧版）：请求通常是无状态的，可选择性设置代理。
• V2 逻辑（当前标准）：
  • 强制代理：必须提供代理 IP 才能运作，以模拟真实的 JA3 指纹与 HTTP/2 流量。
  • 智能挑战：遇到 JavaScript 质询时自动发起挑战。挑战成功后，穿云会存储会话 10 分钟。
  • 自动续期：后续请求若持续成功，会话将自动顺延，极大提升了对复杂 SPA（单页应用）的爬取效率。

Java 请求示例 (基于 OkHttp)

// 规范化代码示例：演示 V2 接口调用
OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/json");

// 构建请求体，适配 V2 异步/同步逻辑
RequestBody body = RequestBody.create(mediaType, "{\"action\": \"proxy\", \"url\": \"https://www.example.com/api/data\"}");

Request request = new Request.Builder()
  .url("https://api.cloudbypass.com")
  .method("POST", body)
  .addHeader("x-cb-apikey", "您的API密钥")
  .addHeader("x-cb-host", "www.example.com")
  .addHeader("x-cb-proxy", "http://user:pass@proxy_host:port") // 必须设置代理
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

快速调试与完整文档

• 代码一键生成：如果您需要生成更复杂的 Java 逻辑，请访问 穿云 API 代码生成器，选择 Java 语言即可获取完整 Demo。
• 详细文档：关于 SDK 的深度集成与高级参数设置，请参阅：穿云 Java 快速入门文档