API 参考
设备 API
获取设备列表

获取设备列表

获取可用的云端设备列表

接口信息

项目
请求方法GET
请求路径/devices

请求参数

参数类型必填说明
brandstring设备品牌,如 xiaomi, huawei
os_versionstring系统版本,如 12, 13
statusstring设备状态:available, busy
pagenumber页码,默认 1
page_sizenumber每页数量,默认 20

请求示例

curl -X GET "https://api.pandatest.net/v1/devices?brand=xiaomi&status=available" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "total": 50,
    "page": 1,
    "page_size": 20,
    "items": [
      {
        "id": "device_001",
        "name": "Xiaomi 13",
        "brand": "xiaomi",
        "model": "2211133C",
        "os_version": "13",
        "screen_size": "6.36",
        "resolution": "2400x1080",
        "status": "available"
      },
      {
        "id": "device_002",
        "name": "Xiaomi 12",
        "brand": "xiaomi",
        "model": "2201123C",
        "os_version": "12",
        "screen_size": "6.28",
        "resolution": "2400x1080",
        "status": "available"
      }
    ]
  }
}

响应字段

字段类型说明
idstring设备唯一标识
namestring设备名称
brandstring品牌
modelstring型号
os_versionstring系统版本
screen_sizestring屏幕尺寸(英寸)
resolutionstring屏幕分辨率
statusstring状态:available/busy