# Получение списка прокси-серверов

Постранично выводит конфигурации прокси команды.
- **Эффект**: отсутствует. Только чтение. Повтор безопасен при ограниченной выдержке.
- **Примечание**: пароли не возвращаются обычным участникам, а также для облачных и динамических прокси. Динамические прокси отображаются здесь, но управляются в другом месте и не редактируются через эндпоинты прокси.

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)
    Идентификатор запроса операции