# 来源白名单 GET 提取接口

说明无登录态 GET 提取如何按真实来源 IPv4 解析账号并返回 JSON 或 TXT。

`GET /api/v1/proxy/extract` 不使用控制台登录态。服务端仅根据真实来源 IPv4 查找启用中的唯一白名单归属。

## GET 请求示例

```bash
curl "<site-origin>/api/v1/proxy/extract?num=10&country=<country-code>&protocol=HTTP&return_type=json"
```

## 调用条件

- 来源 IPv4 已加入当前账号白名单并启用。
- 账号已实名且拥有协议匹配的可用动态住宅权益。
- 请求不经过改变来源的额外代理。

## 接受参数

- 数量、国家或全球值、协议、返回格式和分隔符。
- 每次调用由服务端生成新的请求 ID。
- 调用方传入的身份声明不参与归属。

## 返回

- TXT 直接返回按分隔符组织的 `IP:PORT`。
- JSON 直接返回只含公开 `ip` 和 `port` 的数组。
- 结果顺序随机，不能依赖索引稳定。

## 安全

- 链接仅部署在受控服务端。
- 限制调用频率并避免写入公开日志。
- 来源变化后先更新白名单。

html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}