# 如何通过 API 提取代理地址？

说明登录态提取和来源白名单链接的准备条件、参数、结果与使用限制。

API 提取适合服务端程序批量取得可连接的网关 `IP:PORT`。白名单是提取前置条件，不是独立的代理产品。

## 准备条件

- 完成实名认证。
- 拥有可用动态住宅权益。
- 将调用服务器真实出口 IPv4 添加到白名单并保持启用。

## 调用方式

- 在控制台登录态中提交提取表单。
- 或使用控制台本次返回的无登录态 GET 链接，从白名单来源发起请求。

## 参数边界

- 单次数量为 1–100，默认 10。
- 地区只使用页面支持的国家或全球值。
- 协议使用 HTTP、HTTPS CONNECT 或 SOCKS5 TCP；格式为 JSON 或 TXT。
- 不添加粘性、轮换或州省参数。

## 使用结果

- 结果是我方网关地址，不是永久住宅出口。
- 每次顺序可能不同，程序不得依赖固定索引。