# Obtendo uma lista de proxies

Lista as configurações de proxy da equipe, página por página.
- **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado.
- **Observação**: as senhas são omitidas para membros comuns e para proxies na nuvem e dinâmicos. Os proxies dinâmicos aparecem aqui, mas são gerenciados em outro lugar e não podem ser editados pelos 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 correspondência exata. Envie o ID de 64 bits como string decimal para evitar perda de precisão. Omita para consultar sem filtro por ID. Os demais filtros e a paginação continuam sendo aplicados.
    Example: 1800000000000101

  - `pageNo` (integer)
    Número da página atual (começa em 1)
    Example: 1

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

  - `isCloudPhoneProxy` (boolean)
    Indica se o proxy é para uso em cloud phone.
- `true`: Excluir IPs locais ou privados (por exemplo, 127.0.0.1, 360, pia, faixas privadas)
- `false`: Retornar todos os proxies
    Example: false

  - `proxyCategoryType` (integer)
    Categoria do proxy:
- `1` = Plataforma em nuvem
- `2` = IP próprio
    Example: 2

  - `proxyIp` (string)
    Filtrar por endereço IP do proxy (correspondência parcial)

  - `proxyName` (string)
    Filtrar por nome do proxy (correspondência parcial)

  - `proxyProviders` (array)
    Lista de IDs de tipos de dispositivo de proxy. Valores aceitos:
- `0` = Nenhum
- `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)
    Status de atribuição do proxy:
- `0` = Normal
- `1` = Não atribuído
- `2` = Em atualização
- `3` = Expirado
- `4` = Expira em breve

> Nota: proxies próprios sempre usam o status `1`.
    Example: 1

  - `proxyCheckStatus` (integer)
    Status da verificação do proxy:
- `0` = Pendente
- `1` = Sucesso
- `2` = Falhou
- `3` = Erro desconhecido
    Example: 1

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

## Response 200:

  - `200` (unknown)
    Sucesso. `data.dataList` contém os registros da página solicitada e é um array vazio quando não há correspondências; `data.total`, `data.current` e `data.pages` descrevem a paginação.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado. `0` indica sucesso; outros códigos indicam exceções.

  - `msg` (string | null, required)
    Mensagem de erro

  - `data` (object, required)

  - `data.current` (string, required)

  - `data.dataList` (array, required)

  - `data.dataList.expiryTime` (string)
    Data de expiração

  - `data.dataList.id` (string)
    Chave primária

  - `data.dataList.proxyCategoryType` (integer)
    Tipo de proxy: 1 - proxy da plataforma; 2 - proxy próprio

  - `data.dataList.proxyCheckStatus` (integer)
    Status da detecção: 0 - detecção pendente, 1 - detecção bem-sucedida, 2 - falha na detecção, 3 - erro desconhecido

  - `data.dataList.state` (string | null)
    Estado ou província do proxy. Prioriza a localização detectada do IP de saída e depois a configurada; pode ser null ou uma string vazia.
    Example: California

  - `data.dataList.city` (string | null)
    Cidade do proxy. Prioriza a localização detectada do IP de saída e depois a configurada; pode ser null ou uma string vazia.
    Example: Los Angeles

  - `data.dataList.proxyPort` (integer | null)
    Porta de conexão do proxy; não é deduzida do nome. Pode ser null se indisponível.
    Example: 1080

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

  - `data.dataList.exportIp` (string)
    IP de saída

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

  - `data.dataList.proxyName` (string)
    Nome do proxy

  - `data.dataList.proxyProvider` (integer)
    Tipo de proxy: valor padrão 0 - nenhum 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)
    Usuário do proxy

  - `data.dataList.password` (string)
    Senha do proxy

  - `data.dataList.refreshUrl` (string)
    URL de atualização do proxy

  - `data.pages` (string, required)

  - `data.total` (string, required)

  - `requestId` (string, required)
    ID da solicitação da operação