# 产品简介

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

## 文档结构

* [**产品**](/helodata-zh/chan-pin/overview.md) — 住宅、移动、ISP 三款代理的参考文档
* [**集成指南**](/helodata-zh/ji-cheng-zhi-nan/integrations.md) — Selenium、Puppeteer、Scrapy、反检测浏览器、n8n、LangChain 等即插即用教程
* [**API 参考**](/helodata-zh/api-can-kao/api-reference.md) — 管理订单、子账号、流量、报表的 REST 接口
* [**故障排查**](/helodata-zh/gu-zhang-pai-cha/troubleshooting.md) — 错误码与恢复手册

## 约定

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

| 占位符                | 含义                                                                                                    |
| ------------------ | ----------------------------------------------------------------------------------------------------- |
| `USERNAME`         | 子账号名（例如 `s1a2b3c4d5e`）。完整的代理用户名需要套入 [helodata 用户名语法](/helodata-zh/kuai-su-ru-men/username-format.md)。 |
| `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 个月废弃过渡期。详见[更新日志](/helodata-zh/zi-yuan/changelog.md)。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helodata.com/helodata-zh/kuai-su-ru-men/introduction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
