获取商户下所有设备

接口说明

分页获取当前商户下的设备列表和设备状态。

接口路径: /vmcloud/api/external/getPhoneList
请求类型: GET
响应格式: JSON

请求头

名称 必填 说明
x-ak 访问密钥 ID
x-timestamp 请求时间戳
x-sign 请求签名
x-merchant 商户名称
x-nonce 随机串

请求参数

参数 类型 必填 说明
page number 页码
pageSize number 每页返回数

响应参数

参数 类型 说明
code number 错误码
msg string 错误内容描述
data array 设备列表
equipmentId string 设备 ID
configId string SKU ID
padCode string 设备编码
padName string 设备名称
supplierType string 设备类型
status string 状态,0 删除、1 开机、2 关机
cvmStatus string 操作状态,99 加载中、100 正常、101 截图中、102 重启中、103 重置中、104 重启失败、105 重置失败、106 维护中、107 系统升级中
signExpirationTime string 到期时间
createTime string 创建时间

备注

适合设备总览页和运营管理场景使用。

请求示例

GET /vmcloud/api/external/getPhoneList?page=1&pageSize=20

响应示例

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "equipmentId": "10001",
      "configId": "10",
      "padCode": "PAD001",
      "padName": "云设备001",
      "supplierType": "android",
      "status": "1",
      "cvmStatus": "100",
      "signExpirationTime": "2026-01-01 00:00:00",
      "createTime": "2025-12-01 12:00:00"
    }
  ]
}