# 查询质检任务列表

## 查询质检任务列表

### 简要描述

- 查询提交的质检任务状态
- 查询质检任务结果

### 请求URL

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

### 请求方式

-  GET

### 参数

| 参数名             | 必选 | 类型     | 说明                           |
|:----------------|:---|:-------|------------------------------|
| **token**       | 是  | string | 可以从页面右上角头像右侧下拉菜单中的 “我的信息” 获取 |
| **group_en_id** | 是  | string | 项目英文ID，可在 项目管理/产品管理 页面获取     |
| keyword_in_desc | 否  | string | 描述，支持模糊搜索                    |
| page_size       | 否  | int    | 返回页面数量                       |
| page_index      | 否  | int    | 页面编号，从1开始，表示第几页              |
| start_day       | 否  | string | 筛选项：任务开始日期，如 '2025-06-30'    |
| end_day         | 否  | string | 筛选项：任务结束日期，如 '2025-06-30'    |

## 查询任务状态&获取任务结果

### 简要描述

- 查询提交的质检任务状态
- 查询质检任务结果

### 请求URL

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

### 请求方式

-  GET

### 参数

| 参数名             | 必选  | 类型     | 说明                           |
|:----------------|:----|:-------|------------------------------|
| **token**       | 是   | string | 可以从页面右上角头像右侧下拉菜单中的 “我的信息” 获取 |
| **group_en_id** | 是   | string | 项目英文ID，可在 项目管理/产品管理 页面获取     |
| **plan_id**     | 是   | int    | 质检任务id                       |
| full_info       | 否   | int    | 是(1)否(0，默认)需要测试结果详情          |

### 返回示例

```json
{
  "data": {
    "status": 12, 
    "evaluate_level": "优秀",
    "evaluate_score": 96,
    "tasks": [{
      "auto_plan_id": 111,
      "auto_plan_info": {
        "results": [] 
      }
    }]
  },
  "msg": "success",
  "rtn": 0
}
```

## 提交任务

### 简要描述

- 提交联合任务，现阶段只能提交质检任务
  提交前请确认已在项目管理/产品管理为项目绑定小程序AppID

### 请求URL

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

### 请求方式

-  POST

### 参数

| 参数名              | 必选  | 类型     | 说明                                                                                                                         |
|:-----------------|:----|:-------|----------------------------------------------------------------------------------------------------------------------------|
| **token**        | 是   | string | 可以从页面右上角头像下拉菜单中的 “我的信息”，跳转至我的信息页面，查看“我的Token”                                                                              |
| **group_en_id**  | 是   | string | 项目英文ID，可在 项目管理/产品管理 页面获取                                                                                                   |
| **platforms**    | 是   | string | 运行平台，可选平台: android、ios，多个平台可用英文逗号分割，如`android,ios`                                                                         |
| **wx_version**   | 是   | int    | 小程序版本，`1`：线上版本 `2`：体验版本 `3`：开发版本  (若需要提测体验版本或者开发版本任务，请确认小程序已上传体验版或开发版)                                                     |
| dev_account_no   | 否   | int    | 提交开发版测试时需要填写使用的账号编号，例如使用'ci机器人1'，则传入1即可                                                                                    |
| virtual_accounts | 否   | string | 指定虚拟账号或者真实账号测试，如果指定多个，用英文逗号分割。虚拟账号需要填写虚拟账号的**微信号**，例如 `vaccount7,vaccount8`,获取微信号参考 [虚拟账号的使用](virtual_test)。真实账号填写账号昵称。 |
| wx_id            | 否   | string | 小程序AppID，一般项目无需填写，仅第三方服务商项目需要填写                                                                                            |
| test_plan_id     | 否   | int    | 配置质检任务中，自定义Monkey任务的测试计划                                                                                                   |
| desc             | 否   | string | 测试任务的描述、备注等                                                                                                                |
| special_cloud    | 否   | string | 付费能力，如使用快速测试时填写`fast_test`                                                                                                 |
| device_ids       | 否   | string | 付费能力，指定机型ID提测，如果指定多个，用英文逗号分割。例如 `755,1783`，机型ID可以从提交测试任务页面的自定义机型选择页面获取。                                                    |
| union_type       | 是   | int    | 联合任务类型。`1`：质检任务（默认值）                                                                                                       |

### 返回示例

```python
{
    "data": {
        "plan_id": 73,  # 质检任务ID。注意保存，用于后续查询质检任务状态使用
        "task_msg": "",  # 如果任务创建失败，这里返回失败原因
        "task_result": True
    },
    "msg": "创建成功",
    "rtn": 0,
    "timestamp": 1649313364.4696019
}
```