菜单

云手机列表

使用说明

获取云手机列表，支持分页，单页最大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 过期时间
order	string	否	排序规则，asc 正序；desc 倒序
user_ids	array	否	连接用户ID，可通过云手机连接用户列表获取
tag_ids	array	否	标签ID，可通过标签列表获取
region_id	array	否	os ID，可通过云手机资源列表获取
page	int	否	请求页码，若不传则默认为第一页
pagesize	int	否	每页数量，若不传则默认10条/页

请求示例

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", // os
                "size": "30.08G", // 大小
                "created_at": "2024-04-10 19:14:56",
                "expired_at": "2024-06-10 19:14:56",
                "ip": "xx",
                "area": "xx",
                "remark": "xx",
                "adb": "127.0.0.1:20100",
                "adb_password": ""
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}

上一个

云手机管理

下一个

批量开机

最近修改: 2025-11-26Powered by

大纲