# Obtener una lista de proxies

Lista las configuraciones de proxy del equipo, página a página.
- **Efecto**: ninguno. Solo lectura. Es seguro reintentar con retroceso acotado.
- **Nota**: las contraseñas se omiten para los miembros ordinarios y para los proxies en la nube y dinámicos. Los proxies dinámicos aparecen aquí pero se gestionan en otro sitio y no se pueden editar mediante los endpoints de proxy.

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string)
    ID de proxy opcional para una coincidencia exacta. Envíe el ID de 64 bits como cadena decimal para evitar pérdida de precisión. Omítalo para consultar sin filtrar por ID. Se siguen aplicando los demás filtros y la paginación.
    Example: 1800000000000101

  - `pageNo` (integer)
    Número de página actual (empieza en 1)
    Example: 1

  - `pageSize` (integer)
    Número de elementos por página
    Example: 10

  - `isCloudPhoneProxy` (boolean)
    Indica si el proxy se usa para teléfonos en la nube.
- `true`: Excluir IPs locales o privadas (por ejemplo, 127.0.0.1, 360, pia, rangos privados)
- `false`: Devolver todos los proxies
    Example: false

  - `proxyCategoryType` (integer)
    Categoría del proxy:
- `1` = Plataforma en la nube
- `2` = IP propia
    Example: 2

  - `proxyIp` (string)
    Filtrar por dirección IP del proxy (coincidencia parcial)

  - `proxyName` (string)
    Filtrar por nombre del proxy (coincidencia parcial)

  - `proxyProviders` (array)
    Lista de IDs de tipos de dispositivo de proxy. Valores admitidos:
- `0` = Ninguno
- `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)
    Estado de asignación del proxy:
- `0` = Normal
- `1` = Sin asignar
- `2` = Actualizándose
- `3` = Caducado
- `4` = Caduca pronto

> Nota: los proxies propios siempre usan el estado `1`.
    Example: 1

  - `proxyCheckStatus` (integer)
    Estado de la comprobación del proxy:
- `0` = Pendiente
- `1` = Correcto
- `2` = Fallido
- `3` = Error desconocido
    Example: 1

  - `proxyTypes` (array)
    Tipos de protocolo del proxy:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH
    Example: []

## Response 200:

  - `200` (unknown)
    Correcto. `data.dataList` contiene los registros de la página solicitada y es un array vacío cuando no hay coincidencias; `data.total`, `data.current` y `data.pages` describen la paginación.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado. `0` indica éxito; otros códigos indican excepciones.

  - `msg` (string | null, required)
    Mensaje de error

  - `data` (object, required)

  - `data.current` (string, required)

  - `data.dataList` (array, required)

  - `data.dataList.expiryTime` (string)
    Fecha de caducidad

  - `data.dataList.id` (string)
    Clave principal

  - `data.dataList.proxyCategoryType` (integer)
    Tipo de proxy: 1 - proxy de la plataforma; 2 - proxy propio

  - `data.dataList.proxyCheckStatus` (integer)
    Estado de la detección: 0 - pendiente de detección, 1 - detección correcta, 2 - detección fallida, 3 - error desconocido

  - `data.dataList.state` (string | null)
    Estado o provincia del proxy. Se prioriza la ubicación detectada de la IP de salida y después la configurada; puede ser null o una cadena vacía.
    Example: California

  - `data.dataList.city` (string | null)
    Ciudad del proxy. Se prioriza la ubicación detectada de la IP de salida y después la configurada; puede ser null o una cadena vacía.
    Example: Los Angeles

  - `data.dataList.proxyPort` (integer | null)
    Puerto de conexión del proxy; no se deduce del nombre. Puede ser null si no está disponible.
    Example: 1080

  - `data.dataList.proxyIp` (string)
    IP del proxy

  - `data.dataList.exportIp` (string)
    IP de salida

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

  - `data.dataList.proxyName` (string)
    Nombre del proxy

  - `data.dataList.proxyProvider` (integer)
    Tipo de proxy: valor por defecto 0 - ninguno 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)
    Tipo de proxy: 0 - http, 1 - https, 2 - socks5, 3 - ssh

  - `data.dataList.username` (string)
    Usuario del proxy

  - `data.dataList.password` (string)
    Contraseña del proxy

  - `data.dataList.refreshUrl` (string)
    URL de actualización del proxy

  - `data.pages` (string, required)

  - `data.total` (string, required)

  - `requestId` (string, required)
    ID de solicitud de la operación