# Отримання списку проксі-серверів

Посторінково виводить конфігурації проксі команди.
- **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою.
- **Примітка**: паролі не повертаються звичайним учасникам, а також для хмарних і динамічних проксі. Динамічні проксі відображаються тут, але керуються в іншому місці й не редагуються через ендпоінти проксі.

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string)
    Необов’язковий ID проксі для точного збігу. Передавайте 64-бітний ID десятковим рядком, щоб уникнути втрати точності. Не вказуйте його, щоб не фільтрувати за ID. Інші фільтри та пагінація залишаються чинними.
    Example: 1800000000000101

  - `pageNo` (integer)
    Номер поточної сторінки (починаючи з 1)
    Example: 1

  - `pageSize` (integer)
    Кількість елементів на сторінці
    Example: 10

  - `isCloudPhoneProxy` (boolean)
    Чи використовується проксі для хмарних телефонів.
- `true`: Виключити локальні та приватні IP (наприклад, 127.0.0.1, 360, pia, приватні діапазони)
- `false`: Повернути всі проксі
    Example: false

  - `proxyCategoryType` (integer)
    Категорія проксі:
- `1` = Хмарна платформа
- `2` = Власний IP
    Example: 2

  - `proxyIp` (string)
    Фільтр за IP-адресою проксі (часткова відповідність)

  - `proxyName` (string)
    Фільтр за назвою проксі (часткова відповідність)

  - `proxyProviders` (array)
    Список ID сервісів проксі. Допустимі значення:
- `0` = Немає
- `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)
    Статус призначення проксі:
- `0` = Звичайний
- `1` = Не призначено
- `2` = Оновлюється
- `3` = Прострочено
- `4` = Скоро завершиться

> Примітка: власні проксі завжди мають статус `1`.
    Example: 1

  - `proxyCheckStatus` (integer)
    Статус перевірки проксі:
- `0` = Очікує
- `1` = Успішно
- `2` = Невдало
- `3` = Невідома помилка
    Example: 1

  - `proxyTypes` (array)
    Типи протоколів проксі:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH
    Example: []

## Response 200:

  - `200` (unknown)
    Успіх. `data.dataList` містить записи запитаної сторінки та є порожнім масивом за відсутності відповідників; `data.total`, `data.current` і `data.pages` описують нумерацію сторінок.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Код результату. `0` — успіх; інші коди означають помилку.

  - `msg` (string | null, required)
    Повідомлення про помилку

  - `data` (object, required)

  - `data.current` (string, required)

  - `data.dataList` (array, required)

  - `data.dataList.expiryTime` (string)
    Час завершення дії

  - `data.dataList.id` (string)
    Первинний ключ

  - `data.dataList.proxyCategoryType` (integer)
    Тип проксі: 1 — проксі платформи; 2 — власний проксі

  - `data.dataList.proxyCheckStatus` (integer)
    Статус перевірки: 0 — очікує перевірки, 1 — перевірка успішна, 2 — перевірка не вдалася, 3 — невідома помилка

  - `data.dataList.state` (string | null)
    Штат або область проксі. Пріоритет має визначене розташування вихідного IP, далі використовується налаштоване; можливі null або порожній рядок.
    Example: California

  - `data.dataList.city` (string | null)
    Місто проксі. Пріоритет має визначене розташування вихідного IP, далі використовується налаштоване; можливі null або порожній рядок.
    Example: Los Angeles

  - `data.dataList.proxyPort` (integer | null)
    Порт підключення до проксі; не визначається з імені проксі. Може бути null, якщо недоступний.
    Example: 1080

  - `data.dataList.proxyIp` (string)
    IP проксі

  - `data.dataList.exportIp` (string)
    Зовнішній IP

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

  - `data.dataList.proxyName` (string)
    Назва проксі

  - `data.dataList.proxyProvider` (integer)
    Тип проксі: значення за замовчуванням 0 - немає 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)
    Тип проксі: 0 - http, 1 - https, 2 - socks5, 3 - ssh

  - `data.dataList.username` (string)
    Ім'я користувача проксі

  - `data.dataList.password` (string)
    Пароль проксі

  - `data.dataList.refreshUrl` (string)
    URL оновлення проксі

  - `data.pages` (string, required)

  - `data.total` (string, required)

  - `requestId` (string, required)
    Ідентифікатор запиту операції