# 🤖 Bảng tra cứu nhanh cho Agent

Trang này gói gọn toàn bộ thông tin kết nối EProxies trong một màn hình, dành cho AI Agent và lập trình viên cần tra cứu nhanh. Mọi ví dụ đều chạy được ngay sau khi thay thông tin xác thực của bạn.

## Endpoint

```
Gateway proxy:       proxy.eproxies.net:23333   (HTTP / HTTPS / SOCKS5 dùng chung một cổng)
Bảng điều khiển:     https://dashboard.eproxies.io
Trích xuất API:      https://api.eproxies.net/gateway_api/extract_ip   (chế độ danh sách trắng)
Danh sách quốc gia:  https://api.eproxies.net/gateway_api/country-list
```

Định nghĩa API máy đọc được: [đặc tả OpenAPI](https://www.eproxies.io/docs/openapi.json)

## Cú pháp username (chế độ tài khoản + mật khẩu)

```
{tài khoản}-pool-flow[-region-{mã quốc gia}][-state-{bang}][-city-{thành phố}][-asn-{ASN}][-sid-{8 ký tự ngẫu nhiên}-ttl-{phút}]
```

Quy tắc:

* Thứ tự các đoạn tham số là cố định, ghép từ trái sang phải theo mẫu trên; mật khẩu giữ nguyên.
* `region`: mã quốc gia 2 ký tự theo ISO 3166-1, ví dụ `US`, `GB`, `JP`.
* `state`: tên đầy đủ của bang/tỉnh, ví dụ `California`; `city`: tên thành phố viết thường, bỏ khoảng trắng, ví dụ `losangeles`. **`city` bắt buộc phải đi kèm `state`**.
* `asn`: dạng `AS15802`, **loại trừ lẫn nhau với `state` / `city`** (chỉ được kết hợp cùng `region`).
* `sid` + `ttl`: phiên cố định (sticky session). `sid` là 8 ký tự chữ và số ngẫu nhiên (tự sinh; đổi `sid` là đổi IP); `ttl` là số phút giữ IP, phạm vi **1–120**. Không kèm `sid` thì mỗi request sẽ tự động xoay IP.

Ví dụ (từ đơn giản đến đầy đủ):

```
USERNAME-pool-flow                                                    # Ngẫu nhiên toàn cầu, xoay IP theo từng request
USERNAME-pool-flow-region-US                                          # IP Mỹ
USERNAME-pool-flow-region-US-state-California                         # Bang California, Mỹ
USERNAME-pool-flow-region-US-state-California-city-losangeles         # Los Angeles, California, Mỹ
USERNAME-pool-flow-region-AE-asn-AS15802                              # UAE, chỉ định ASN
USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30                      # IP Mỹ, giữ nguyên IP trong 30 phút
```

## Ví dụ tối thiểu chạy được

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

# Proxy SOCKS5 (cùng một cổng)
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));
```

## Chế độ danh sách trắng (trích xuất không cần mật khẩu)

Sau khi IP đầu ra được thêm vào danh sách trắng, dùng GET để trích xuất danh sách `IP:cổng` và kết nối trực tiếp, không cần tài khoản/mật khẩu. Bản thân danh sách trắng cũng quản lý được qua API:

```bash
# Trích xuất: count bắt buộc; country=mã quốc gia/Global; protocol=http|socks5; format=txt|json;
#             session=sticky|random; separator=crlf|br|cr|lf|tab (hoặc st=ký tự phân tách tùy chỉnh)
curl "https://api.eproxies.net/gateway_api/extract_ip?count=10&country=US&protocol=http&format=json&session=sticky"

# Quản lý danh sách trắng (userKeyValue=khóa người dùng, lấy trong bảng điều khiển)
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"

# Danh sách quốc gia được hỗ trợ
curl "https://api.eproxies.net/gateway_api/country-list"
```

Xem chi tiết tại [Trích xuất qua API](https://www.eproxies.io/docs/usage/api-extraction).

## Những điều cần nhớ

* Thông tin xác thực kích hoạt ngay sau khi mua; hết lưu lượng thì mua thêm, **thông tin xác thực không đổi, không gián đoạn dịch vụ**.
* Lưu lượng chưa dùng hết vẫn tiếp tục sử dụng được trong thời hạn hiệu lực của gói.
* Muốn đổi IP giữa chừng trong phiên cố định: chỉ cần đổi `sid`.
* Định vị đến cấp thành phố không tính thêm phí.
* Dịch vụ chỉ được phép sử dụng bên ngoài Trung Quốc đại lục.
* Hỗ trợ: [Telegram](https://t.me/eproxies) / [Discord](https://discord.gg/yzZNxN75) (24/7), email `support@eproxies.io`.