特别提示: 虽然本文档介绍 V1 版本,但为了获得更强大的 JA3 指纹模拟与 HTTP/2 支持,建议优先参考 V2 接口文档 进行升级。
1. 注册穿云账号
首先,您需要注册一个穿云管理后台账号,用于管理您的 API 密钥与资源。
- 穿云 API 注册/管理后台:https://console.cloudbypass.com/#/api/account
2. 购买/领取积分套餐
穿云 API 采用积分计费制,您可以根据需求获取测试额度:
- 新手试用:注册 30 天内登录后台,点击“活动”按钮即可领取新手试用礼包。
- 套餐购买:如需更多积分,请访问 账户中心 选购适合您的套餐。
3. 使用代码生成器调试
在正式集成前,通过可视化工具进行联调。
如何区分 V1 与 V2 接口?
- V1 接口:通常请求地址以
/v1/结尾,参数结构相对固定(主要针对简单的请求中转)。 - V2 接口:地址以
/v2/instance结尾。其核心特征是包含action字段(如request.get)以及更复杂的body结构,支持全栈指纹模拟。
👉 前往:穿云代码生成器测试
(在生成器页面,您可以直接切换不同的版本模式,系统会自动为您生成对应的 JSON 逻辑)
4. 将 API 集成到您的脚本中
当您在代码生成器中测试通过(即成功获取目标网页源码)后,按照以下步骤进行本地集成:
- 复制生成的 Headers 与 Body:将代码生成器生成的请求头(Headers)和 JSON 请求体(Body)完整复制。
- 替换 API Key:在您的脚本中,将生成的代码片段里的
Proxy-Authorization或相关字段替换为您后台真实的 API Key。 - 部署运行:确保您的开发环境能够正常访问
api.cloudbypass.com。若在中国大陆环境下使用,建议部署在香港或海外服务器上,或开启 TUN 模式进行中转。