# 🤖 Agent 速查表

本页把 EProxies 全部接入信息压缩在一屏内,面向 AI Agent 和需要快速查阅的开发者。所有示例可直接替换凭据后运行。

## 端点

```
代理网关:   proxy.eproxies.net:23333   (HTTP / HTTPS / SOCKS5 共用同一端口)
控制台:     https://dashboard.eproxies.io
API 提取:   https://api.eproxies.net/gateway_api/extract_ip   (白名单模式)
国家列表:   https://api.eproxies.net/gateway_api/country-list
```

完整机器可读接口定义:[OpenAPI 规范](https://www.eproxies.io/docs/openapi.json)

## Username 语法(账密模式)

```
{账号}-pool-flow[-region-{国家码}][-state-{州名}][-city-{城市}][-asn-{ASN}][-sid-{8位随机}-ttl-{分钟}]
```

规则:

* 各参数段顺序固定,按上式从左到右拼接,密码不变。
* `region`:ISO 3166-1 两位国家码,如 `US`、`GB`、`JP`。
* `state`:州/省全称,如 `California`;`city`:城市名小写去空格,如 `losangeles`。**city 必须与 state 同时出现**。
* `asn`:形如 `AS15802`,**与 state / city 互斥**(只能与 region 组合)。
* `sid` + `ttl`:粘性会话。`sid` 为 8 位随机字母数字(自行生成,换 sid 即换 IP);`ttl` 为保持分钟数,范围 **1–120**。不带 `sid` 则每次请求自动轮换 IP。

示例(从简到繁):

```
USERNAME-pool-flow                                                    # 全球随机,逐请求轮换
USERNAME-pool-flow-region-US                                          # 美国 IP
USERNAME-pool-flow-region-US-state-California                         # 美国加州
USERNAME-pool-flow-region-US-state-California-city-losangeles         # 美国加州洛杉矶
USERNAME-pool-flow-region-AE-asn-AS15802                              # 阿联酋指定 ASN
USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30                      # 美国 IP,同一 IP 保持 30 分钟
```

## 最小可用示例

```bash
# HTTP 代理
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US:PASSWORD" https://ipinfo.io

# SOCKS5 代理(同一端口)
curl -x socks5://USERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333 https://ipinfo.io
```

```python
import requests

proxy_url = "http://USERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333"
proxies = {"http": proxy_url, "https": proxy_url}
print(requests.get("https://ipinfo.io", proxies=proxies, timeout=30).json())
```

```javascript
const { HttpsProxyAgent } = require("https-proxy-agent");
const axios = require("axios");

const agent = new HttpsProxyAgent(
  "http://USERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333"
);
axios.get("https://ipinfo.io", { httpsAgent: agent }).then((r) => console.log(r.data));
```

## 白名单模式(免密提取)

出口 IP 加入白名单后,GET 提取 `IP:端口` 列表直连,无需账密。白名单本身也可 API 管理:

```bash
# 提取:count 必填;country=国家码/Global;protocol=http|socks5;format=txt|json;
#       session=sticky|random;separator=crlf|br|cr|lf|tab(或 st=自定义分隔符)
curl "https://api.eproxies.net/gateway_api/extract_ip?count=10&country=US&protocol=http&format=json&session=sticky"

# 白名单管理(userKeyValue=用户密钥,控制台获取)
curl "https://api.eproxies.net/gateway_api/add-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"
curl "https://api.eproxies.net/gateway_api/del-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"
curl "https://api.eproxies.net/gateway_api/lists-ip?userName=USERNAME&userKeyValue=USER_KEY"

# 支持的国家列表
curl "https://api.eproxies.net/gateway_api/country-list"
```

详见 [API 提取](https://www.eproxies.io/docs/usage/api-extraction)。

## 关键事实

* 凭据在购买后即时激活;流量用尽后加购,**凭据不变、无停机**。
* 未用完的流量在套餐有效期内可继续使用。
* 粘性会话中途换 IP:更换 `sid` 即可。
* 定位到城市不额外收费。
* 服务仅限中国大陆以外地区使用。
* 支持:[Telegram](https://t.me/eproxies) / [Discord](https://discord.gg/yzZNxN75)(24/7),邮箱 `support@eproxies.io`。