# API 提取代理地址

概述 API 提取的来源白名单、登录态 POST、无登录态 GET、参数与返回结果。

API 提取适合服务端程序批量取得只只HTTP代理网关 `IP:PORT`。调用前需要实名认证、可用动态住宅权益和启用中的来源 IPv4 白名单。

## 两条入口

- 登录态 `POST /api/v1/proxy/extract` 由控制台用户选择权益与白名单。
- 无登录态 `GET /api/v1/proxy/extract` 仅按真实来源 IPv4 解析归属。
- GET 不依赖调用方声明的账号或身份字段。

## 参数范围

- 单次 1–100 个，默认 10。
- 地区使用页面提供的国家或全球值。
- 协议为 HTTP、HTTPS CONNECT 或 SOCKS5 TCP。
- 不传入轮换、粘性或州省参数。

## 返回语义

- 结果是公开网关地址，不是永久住宅出口。
- JSON 或 TXT 顺序可能随机变化。
- 调用方不得依赖固定端口索引。

## 安全与重试

- 完整 GET 链接和结果只在受控服务端使用。
- POST 重试复用原 requestId。
- 资格和参数错误修正后再请求。