# Lấy danh sách máy chủ proxy

Liệt kê theo trang các cấu hình proxy của nhóm.
- **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn.
- **Lưu ý**: mật khẩu không được trả về cho thành viên thường, cũng như với proxy cloud và proxy động. Proxy động xuất hiện ở đây nhưng được quản lý ở nơi khác và không thể sửa qua các endpoint proxy.

Endpoint: POST /proxyInfo/page
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string)
    ID proxy tùy chọn để khớp chính xác. Gửi ID 64 bit dưới dạng chuỗi thập phân để tránh mất độ chính xác. Bỏ qua để không lọc theo ID. Các bộ lọc khác và phân trang vẫn áp dụng.
    Example: 1800000000000101

  - `pageNo` (integer)
    Số trang hiện tại (bắt đầu từ 1)
    Example: 1

  - `pageSize` (integer)
    Số mục trên mỗi trang
    Example: 10

  - `isCloudPhoneProxy` (boolean)
    Proxy có dùng cho cloud phone hay không.
- `true`: Loại trừ IP nội bộ hoặc riêng tư (ví dụ: 127.0.0.1, 360, pia, các dải riêng)
- `false`: Trả về tất cả proxy
    Example: false

  - `proxyCategoryType` (integer)
    Loại danh mục proxy:
- `1` = Nền tảng đám mây
- `2` = IP tự sở hữu
    Example: 2

  - `proxyIp` (string)
    Lọc theo địa chỉ IP của proxy (khớp một phần)

  - `proxyName` (string)
    Lọc theo tên proxy (khớp một phần)

  - `proxyProviders` (array)
    Danh sách ID Loại proxy. Giá trị được hỗ trợ:
- `0` = Không có
- `4` = Oxylabs
- `5` = Proxys.io
- `6` = GeoSurf
- `7` = Luminati
- `8` = Lumauto
- `9` = Oxylabsauto
- `10` = Trojan
- `11` = Shadowsocks
- `12` = vmess
- `13` = ABCPROXY
- `14` = LunaProxy
- `15` = IPHTML
- `16` = PiaProxy
- `17` = 922S5
    Example: []

  - `proxyStatus` (integer)
    Trạng thái gán proxy:
- `0` = Bình thường
- `1` = Chưa gán
- `2` = Đang nâng cấp
- `3` = Đã hết hạn
- `4` = Sắp hết hạn

> Lưu ý: proxy tự sở hữu luôn dùng trạng thái `1`.
    Example: 1

  - `proxyCheckStatus` (integer)
    Trạng thái kiểm tra proxy:
- `0` = Đang chờ
- `1` = Thành công
- `2` = Thất bại
- `3` = Lỗi không xác định
    Example: 1

  - `proxyTypes` (array)
    Các loại giao thức proxy:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH
    Example: []

## Response 200:

  - `200` (unknown)
    Thành công. `data.dataList` chứa các bản ghi của trang được yêu cầu và là mảng rỗng khi không có kết quả khớp; `data.total`, `data.current` và `data.pages` mô tả phân trang.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Mã kết quả. `0` là thành công; các mã khác biểu thị ngoại lệ.

  - `msg` (string | null, required)
    Thông báo lỗi

  - `data` (object, required)

  - `data.current` (string, required)

  - `data.dataList` (array, required)

  - `data.dataList.expiryTime` (string)
    Thời điểm hết hạn

  - `data.dataList.id` (string)
    Khóa chính

  - `data.dataList.proxyCategoryType` (integer)
    Loại proxy: 1 - proxy của nền tảng; 2 - proxy tự sở hữu

  - `data.dataList.proxyCheckStatus` (integer)
    Trạng thái kiểm tra: 0 - đang chờ kiểm tra, 1 - kiểm tra thành công, 2 - kiểm tra thất bại, 3 - lỗi không xác định

  - `data.dataList.state` (string | null)
    Bang hoặc tỉnh của proxy. Ưu tiên vị trí IP đầu ra được phát hiện, sau đó dùng vị trí cấu hình; có thể là null hoặc chuỗi rỗng.
    Example: California

  - `data.dataList.city` (string | null)
    Thành phố của proxy. Ưu tiên vị trí IP đầu ra được phát hiện, sau đó dùng vị trí cấu hình; có thể là null hoặc chuỗi rỗng.
    Example: Los Angeles

  - `data.dataList.proxyPort` (integer | null)
    Cổng kết nối proxy, không suy ra từ tên proxy. Có thể là null nếu không có.
    Example: 1080

  - `data.dataList.proxyIp` (string)
    IP của proxy

  - `data.dataList.exportIp` (string)
    IP xuất

  - `data.dataList.countryCode` (string)
    countryCode

  - `data.dataList.proxyName` (string)
    Tên proxy

  - `data.dataList.proxyProvider` (integer)
    Loại proxy: giá trị mặc định 0 - không có 4-Oxylabs 5-Proxys.io 7-Luminati 8-Lumauto 9-Oxylabsauto 10-Trojan，11-Shadowsocks 13-ABCPROXY 14-LunaProxy 15-IPHTML 16-PiaProxy 17-922S5

  - `data.dataList.proxyType` (integer)
    Loại proxy: 0 - http, 1 - https, 2 - socks5, 3 - ssh

  - `data.dataList.username` (string)
    Tên người dùng proxy

  - `data.dataList.password` (string)
    Mật khẩu proxy

  - `data.dataList.refreshUrl` (string)
    URL làm mới proxy

  - `data.pages` (string, required)

  - `data.total` (string, required)

  - `requestId` (string, required)
    ID yêu cầu của thao tác