菜单

云手机列表

使用说明

获取云手机列表，支持分页查询，每页最多支持 100 条记录。

请求说明

POST /api/v1/cloudPhone/list

请求参数

参数	类型	必填	描述
`image_id`	array	否	ID
`name`	string	否	名称
`group_id`	string	否	分组 ID，可从云手机分组列表获取
`remark`	string	否	备注
`ips`	array	否	IP 地址
`link_status`	array	否	云手机状态：`0` 未配置代理；`1` 已开机；`2` 已关机；`3` 已过期；`4` 过期待续费；`10` 开机中；`11` 配置中；`12` 配置失败
`proxy_id`	string	否	代理 ID，可从代理列表获取
`share_status`	array	否	分享状态：`0` 未配置；`1` 开启；`2` 关闭
`start_phone_type`	array	否	开机方式：`1` 包月开机优先；`2` 包月开机；`3` 临时开机
`adb_status`	array	否	ADB 状态：`0` 关闭；`1` 开启
`renewal_status`	array	否	自动续费：`0` 关闭；`1` 开启
`sort_by`	string	否	排序字段。`name` 名称；`created_at` 创建时间；`expired_at` 到期时间；`os` Android 版本
`order`	string	否	排序方式：`asc` 升序；`desc` 降序
`user_ids`	array	否	连接用户ID ID，可从云手机连接用户列表获取
`tag_ids`	array	否	标签 ID，可从标签列表获取
`region_id`	array	否	OS ID，可从云手机资源列表获取
`page`	int	否	请求的页码。如果不传，默认为第 1 页
`pagesize`	int	否	每页返回的数据条数。如果不传，默认为每页 10 条

响应参数

参数	类型	描述
`id`	string	云手机 ID
`name`	string	云手机名称
`status`	integer	云手机状态：`0` 未配置代理；`1` 已开机；`2` 已关机；`3` 已过期；`4` 过期待续费；`10` 开机中；`11` 配置中；`12` 配置失败
`adb_status`	string	ADB 状态，`1` 开启；`0` 关闭
`adb`	string	ADB 地址
`adb_password`	string	ADB 密码
`remark`	string	备注
`os`	string	安卓版本，可能为空
`size`	string	存储空间大小
`group`	array	分组信息
`area`	string	地区
`ip`	string	云手机 IP 地址
`http_status`	string	HTTP 服务是否启用：`1` 是；`0` 否
`region`	string	云手机所在区域
`created_at`	string	创建时间
`expired_at`	string	到期时间
`convert_version_times`	integer	转换版本次数
`free_new_mock_times`	integer	免费一键新机次数
`paid_new_mock_times`	integer	付费一键新机次数
`new_mock_times`	integer	总一键新机次数
`android_version_configured`	boolean	是否配置了安卓版本，true 是； false 否

请求示例

json 复制代码

{
    "page": 1,
    "pagesize": 10,
    "link_status": ["0"],
    "tag_ids": ["xxx"],
    "group_id": "xxx",
    "share_status": ["1"],
    "region_id": ["xxx"],
    "adb_status": ["1"],
    "sort_by": "created_at",
    "order": "desc",
    "image_id": ["xxx"],
    "ips": ["xxx"],
    "name": "xxx",
    "start_phone_type": ["1"],
    "renewal_status": ["0"],
    "remark": "xxx",
    "user_ids": ["xxx"],
    "proxy_id": "xxx"
}

响应示例

json 复制代码

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "xx", // 云手机 ID
                "name": "xx", // 云手机名称
                "status": 1, // 状态：0 未配置；1 已开机；2 已关机；3 已过期；4 过期待续费；10 开机中；11 配置中；12 配置失败
                "os": "Android 12", // 操作系统
                "size": "30.08G", // 存储空间大小
                "created_at": "2024-04-10 19:14:56", // 创建时间
                "expired_at": "2024-06-10 19:14:56", // 到期时间
                "ip": "xx", // 云手机 IP
                "area": "xx", // 区域
                "remark": "xx", // 备注
                "adb_status": 0,           // ADB 状态，0 关闭；1 开启
                "adb": "127.0.0.1:20100",  // ADB 地址
                "adb_password": "",        // ADB 密码
                "group": [
                    {
                        "id": "xxxx", // 分组 ID
                        "name": "xxxx" // 分组名称
                    },
                    {
                        "id": "xxxx",
                        "name": "xxxx"
                    }
                ],
                "ip": "xx.xx.xx.xx",            // 云手机 IP
                "http_status": 0,               // HTTP 服务是否启用：1 是；0 否
                "region": "xxxx"，              // 云手机区域，
                "convert_version_times": 1,     // 转换版本次数
                "free_new_mock_times": 10,      // 免费一键新机次数
                "paid_new_mock_times": 40,      // 付费一键新机次数
                "new_mock_times": 50            // 总一键新机次数
                "android_version_configured": true
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}

最近修改: 2026-10-20Powered by

大纲