# 获取代理列表

分页列出团队的代理配置。
- **副作用**：无。只读。可带退避安全重试。
- **说明**：普通成员看不到密码，云代理和动态代理的密码也不会返回。动态代理会出现在这里，但它们由别处管理，无法通过代理接口编辑。

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)
    主键 ID

  - `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)
    国家代码

  - `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)
    操作请求 ID