# 获取机型列表

## 简要描述

- 查询目前可供选择的机型（仅对[付费项目](test_time)开放查询），在提交任务时，使用返回的机型id(model_id)来实现指定机型跑测

## 请求URL

- `https://minitest.weixin.qq.com/thirdapi/device_list`

## 请求方式

-  GET

## 参数

| 参数名             | 必选 | 类型     | 说明                                  |
|:----------------|:---|:-------|-------------------------------------|
| **token**       | 是  | string | 可以从页面右上角头像右侧下拉菜单中的 “我的信息” 获取        |
| **group_en_id** | 是  | string | 项目英文ID，可在 项目管理/产品管理 页面获取            |
| model_name      | 否  | string | 机型别名，如iPhone 15, 模糊搜索               |
| level           | 否  | int    | 机型单次，只能从1,2,3中选择。其中： 1-高档，2-中档，3-低档 |
| phone_type      | 否  | int    | 平台，只能从ios，android，harmony选择         |
| page_index      | 否  | int    | 第 n 页，从1开始，默认-1，表示不分页               |
| page_size       | 否  | int    | 每页返回数量，默认为-1，表示不分页                  |

## 返回示例

```json
{
  "data":{
	"total_device_num": 1,
	"device_list": [{
		"cpu_name": "海思 麒麟980",
		"cpu_total": 8,
		"level": 2,
		"manufacture": "HUAWEI",
		"model": "SEA-AL10",
		"model_alias": "华为nova 5 Pro",
		"model_id": 1,
		"phone_type": "android",
		"resolution": "1080x2340",
		"special_cloud": "",
		"system_version": "Android 9"
	}],
  },
  "msg":"ok",
  "rtn":0,
  "timestamp":1654507309.8952177,
  "trace_id":"5f7884d3953a2e18"
}
```

## 备注
> 请注意，该接口只对付费项目开放查询

`level`字段含义：1 高端机、2 中端机、3 低端机