# 获取云手机列表

分页列出团队可见的云手机。
- **副作用**：无。只读。可带退避安全重试。
- **说明**：会返回所有设备类型的云手机。托管代理与动态代理的密码会从响应中移除。
- **用途**：本接口与 `/cloudphone/info` 是开关机、一键新机和开通这几个异步操作的完成信号。

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `bindIp` (boolean)
    IP地址是否绑定：true = 已绑定，false = 未绑定
    Example: false

  - `keyword` (string)
    筛选关键词：代理信息、组名、标签名、环境名
    Example: CP-424

  - `pageNo` (integer)
    当前页面
    Example: 1

  - `pageSize` (integer)
    每页项目数
    Example: 100

  - `sort` (array)
    动态排序字段。目前云手机仅支持“envName”字段。
    Example: [{"sortDirection":"asc","sortField":"envName"}]

  - `sort.sortDirection` (string, required)
    排序方向
    Enum: "asc", "desc"

  - `sort.sortField` (string, required)
    排序依据字段（目前仅支持“envName”）
    Example: envName

## Response 200:

  - `200` (unknown)
    好的

## 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.abnormalStatus` (integer)
    异常状态：0-无异常；1-未激活；2-合约到期；3-超卖；4-已停用

  - `data.dataList.adbInfo` (object)

  - `data.dataList.adbInfo.adbIp` (string, required)
    adb ip

  - `data.dataList.adbInfo.adbPassword` (string, required)
    adb 连接密码

  - `data.dataList.adbInfo.adbPort` (string, required)
    adb端口

  - `data.dataList.adbInfo.remark` (string, required)
    故障备注信息

  - `data.dataList.adbInfo.success` (integer, required)
    成功收购：1=是，0=否

  - `data.dataList.billingType` (integer)
    计费方式: 1 按量/按分钟, 2 包月

  - `data.dataList.createDate` (string)
    创建时间

  - `data.dataList.createMember` (integer)
    创建用户

  - `data.dataList.createMemberName` (string)
    创建用户昵称

  - `data.dataList.enableAdb` (boolean)
    是否开启adb

  - `data.dataList.envName` (string)
    云手机名称

  - `data.dataList.envRemark` (string)
    环境备注

  - `data.dataList.envStatus` (integer)
    浏览器环境状态：0-新建 1-创建失败 2-停止 3-正在启动 4-启动 5-重置中

  - `data.dataList.expireTime` (string)
    有效期

  - `data.dataList.groupId` (string)
    分组Id

  - `data.dataList.groupName` (string | null)
    分组名称。云手机未分组时为 null

  - `data.dataList.id` (string)
    ml云手机Id

  - `data.dataList.androidId` (string)
    云手机 android id

  - `data.dataList.gaid` (string)
    云手机 gaid

  - `data.dataList.lastConnectDate` (string)
    最后连接时间

  - `data.dataList.lastConnectMemberId` (string)
    最后一次连接人ID

  - `data.dataList.lastConnectMemberName` (string)
    最后一次连接人名称

  - `data.dataList.lastStartDate` (string)
    最后开机时间

  - `data.dataList.lastStartMemberId` (string)
    最后开机人ID

  - `data.dataList.lastStartMemberName` (string)
    最后开机人名称

  - `data.dataList.proxy` (object)

  - `data.dataList.proxy.country` (string, required)
    国家

  - `data.dataList.proxy.countryCode` (string, required)
    国家编码

  - `data.dataList.proxy.createDate` (string, required)
    创建时间

  - `data.dataList.proxy.delFlag` (integer, required)
    1 - 已删除 2 - 未删除

  - `data.dataList.proxy.expiryTime` (string, required)
    过期时间

  - `data.dataList.proxy.exportIp` (string, required)
    出口Ip

  - `data.dataList.proxy.groupId` (string, required)
    分组Id

  - `data.dataList.proxy.id` (string, required)
    主键

  - `data.dataList.proxy.providerCode` (string, required)
    设备区域

  - `data.dataList.proxy.proxyAreaCode` (string, required)
    平台代理区域

  - `data.dataList.proxy.proxyCatagoryType` (integer, required)
    代理类型：0：站点组 1：云平台 2：自有IP 3：VPS 4：虚拟机

  - `data.dataList.proxy.proxyCheckStatus` (integer, required)
    检测状态：0：待检测；1：检测成功；2：检测失败；3：未知错误

  - `data.dataList.proxy.proxyInfo` (string, required)
    代理信息

  - `data.dataList.proxy.state` (string | null)
    代理所在州或省。优先返回出口 IP 探测地域，缺失时使用配置地域；可能为 null 或空字符串。
    Example: California

  - `data.dataList.proxy.city` (string | null)
    代理所在城市。优先返回出口 IP 探测地域，缺失时使用配置地域；可能为 null 或空字符串。
    Example: Los Angeles

  - `data.dataList.proxy.proxyIp` (string, required)
    代理Ip

  - `data.dataList.proxy.proxyName` (string, required)
    代理名称

  - `data.dataList.proxy.proxyPort` (integer | null, required)
    代理连接端口，不从代理名称推断；不可用时可能为 null。
    Example: 1080

  - `data.dataList.proxy.proxyRegionCode` (string, required)
    平台代理国家

  - `data.dataList.proxy.proxyStatus` (integer, required)
    0-正常 1-待分配 2-升级中 3-已过期

  - `data.dataList.proxy.proxySub` (object, required)

  - `data.dataList.proxy.proxySub.activeRecordId` (string, required)
    激活中的订阅记录

  - `data.dataList.proxy.proxySub.businessId` (string, required)
    代理Id

  - `data.dataList.proxy.proxySub.createMember` (integer, required)
    创建用户

  - `data.dataList.proxy.proxySub.endTime` (string, required)
    结束时间

  - `data.dataList.proxy.proxySub.id` (string, required)
    订阅Id

  - `data.dataList.proxy.proxySub.nextBillingTime` (string, required)
    下次扣款时间

  - `data.dataList.proxy.proxySub.startTime` (string, required)
    有效期

  - `data.dataList.proxy.proxySub.subPayMethod` (string, required)
    支付方式

  - `data.dataList.proxy.proxySub.subStatus` (integer, required)
    订阅状态：0-待定 1-已订阅 2-已取消

  - `data.dataList.proxy.proxySub.subType` (integer, required)
    订阅类型：1-代理 2-套餐

  - `data.dataList.proxy.proxySub.teamId` (string, required)
    成员Id

  - `data.dataList.proxy.proxyType` (integer, required)
    代理类型：0-http 1-https 2-socks5 4-Oxylabs 5-Proxys.io 6-GeoSurf 9-Oxylabsauto 10-Trogan 11-Shadowsocks 12-vmess

  - `data.dataList.proxy.proxyTypeCode` (string, required)
    平台代理类型编码

  - `data.dataList.proxy.regionKey` (string, required)
    云平台Key

  - `data.dataList.proxy.releaseTime` (string, required)
    释放时间：如果已删除则为删除时间，如果已过期则为过期时间

  - `data.dataList.proxy.uniqueId` (integer, required)
    排序Id

  - `data.dataList.proxyStatus` (integer)
    代理状态：0-未检测到；1-正在检测；2-检测失败；3-检测成功

  - `data.dataList.supportAdb` (boolean)
    是否支持adb 0-不支持 1-支持

  - `data.dataList.tagInfos` (array)
    标签信息。未分配标签时为空数组

  - `data.dataList.tagInfos.id` (string, required)
    标签 ID

  - `data.dataList.tagInfos.tagName` (string, required)
    标签名称

  - `data.dataList.updateDate` (string)
    修改时间

  - `data.dataList.updateMember` (integer)
    修改用户

  - `data.pages` (string, required)

  - `data.total` (string, required)

  - `requestId` (string, required)
    操作请求 ID