提交联合任务 | 微信开放文档

# 提交联合任务

联合任务是将平台的测试能力通过组合的方式，创建的任务。

目前平台支持的联合任务只有质检任务。

# 简要描述

提交联合任务，现阶段只能提交质检任务提交前请确认已在项目管理/产品管理为项目绑定小程序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`,获取微信号参考虚拟账号的使用。真实账号填写账号昵称。
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`：质检任务（默认值）

# 返回示例

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