产品简介

helodata 是面向工程师的代理平台。我们运维 IP 基础设施、轮换逻辑与地理定位——你只需要发起 HTTP 请求。

文档结构

• 产品 — 住宅、移动、ISP 三款代理的参考文档
• 集成指南 — Selenium、Puppeteer、Scrapy、反检测浏览器、n8n、LangChain 等即插即用教程
• API 参考 — 管理订单、子账号、流量、报表的 REST 接口
• 故障排查 — 错误码与恢复手册

约定

代码示例中的占位符如下，请替换为控制台中的实际值。

占位符	含义
USERNAME	子账号名（例如 s1a2b3c4d5e）。完整的代理用户名需要套入 helodata 用户名语法。
PASSWORD	子账号密码
gate.helodata.io	代理网关主机名
7777	默认的 HTTP/SOCKS5 端口
API_KEY	在 控制台 → API 中签发的 REST API 密钥

每个代理用户名都遵循同一种结构：

helo_{username}-type-{type}-region-{region}[-state-{state}][-city-{city}][-asn-{asn}][-session-{session_id}-sesstime-{ttl}]

如果示例显示 helo_s1a2b3c4d5e-type-res-region-us，你需要替换的就是其中的 s1a2b3c4d5e 部分。

所有示例默认在类 Unix shell 下运行，Windows 用户请相应调整引号。

版本管理

REST API 通过 URL 进行版本管理（/v1/...）。破坏性变更会以新的主版本发布，并提供 6 个月废弃过渡期。详见更新日志。