穿云 API V2 接口请求体参数配置指南

针对 Cloudflare 5 秒盾(JavaScript Challenge) 的处理,在 V2 接口 标准下,请求体的配置核心在于动作指令(action)业务参数(body)的分离。

1. 核心逻辑

您无需手动处理复杂的解密逻辑。在发送请求时,只需将原始抓包获取的请求体直接透传,并将校验逻辑交给穿云 API 调度。

2. V2 请求体 JSON 结构示例

在调用 https://api.cloudbypass.com/v2/instance(或同步接口)时,请求体应按照以下结构规范组织:

{
    "url": "https://target-website.com/api/data",
    "method": "POST",
    "action": "request", // 核心动作:告知 API 执行绕过并发送请求
    "headers": {
        "Content-Type": "application/json",
        "User-Agent": "Mozilla/5.0..." // 建议保持与抓包一致,穿云会自动进行指纹对齐
    },
    "body": "{\"key\": \"value\"}", // 这里的 body 填写您抓包获取的原始请求体(字符串形式)
    "proxy_address": "your_proxy_id" // 可选:指定引用的代理地址
}

3. 技术校对要点

  • 请求体透传:直接使用抓包获得的原始数据填充 body 字段。如果原请求是 JSON 格式,在填充时请注意转义(或作为字符串处理)。
  • 配置重心在 Header:确保 Content-Type 与原始请求完全一致。穿云 API 会在底层自动注入 JA3 指纹HTTP/2 特征,确保请求环境的真实性。
  • V2 异步逻辑:对于高难度的 5 秒盾,建议使用 v2/instance 异步创建任务,通过返回的 task_id 获取最终渲染后的数据。

快速调试建议

如果您不确定复杂的 POST 请求体如何转义,建议直接使用官方工具生成标准的 V2 调用代码:

👉 穿云 API 代码生成器(V2 专版)

该工具可以自动将您的抓包参数转化为 100% 兼容穿云系统的代码段,支持 Python、Node.js 及 Go 语言。