# Submit a test task

# Brief description

• Submit a test task Make sure you bind the Weixin Mini Program AppID to the project in item management / product management before submitting

# Request URL

• https://minitest.weixin.qq.com/thirdapi/plan

# How to request

• POST

# parameter

# Return an example

{
	"data": {
		"plan_id": 2210
	},
	"msg": "添加成功，等待后台创建任务。",
	"rtn": 0,
	"timestamp": 1649313364.4696019
}

# Query tasks

# 1. Query Task List

# Brief description

• Query submitted test tasks

# Request URL

• https://minitest.weixin.qq.com/thirdapi/plan_list

# How to request

• GET

# parameter

# Return an example

{
  "data": {
    "plan_list": [{
      "android_num": 1,
      "appid": "wxbb9a805eb4f9533c",
      "case_plan_name": "智能化Monkey",
      "create_time": "2022-03-30 17:53:11",
      "desc": "",
      "end_time": "2022-03-30 18:35:25",
      "id": 31768,
      "ios_num": 0,
      "platforms": "android",
      "start_time": "2022-03-30 18:29:27",
      "status": 12,
      "status_info": "测试结束",
      "success_rate": 1.0,
      "test_type_info": "Monkey",
      "user_name": "user1",
      "wx_version_info": "线上版本"
    }],    // 当前返回的提测任务列表
    "total_num": 10,  // 项目总共提测任务数量
  },
  "msg": "OK",
  "rtn": 0,
  "timestamp": 1614861228.1035924
}

# 2. Query Task Status & Get Task Results

# Brief description

• Query the status of submitted automated test tasks (results)

# Request URL

• https://minitest.weixin.qq.com/thirdapi/plan

# How to request

• GET

# parameter

# Return an example

{
	"data": {
		"status": 2,
		"status_text": "测试中"
	},
	"msg": "OK",
	"rtn": 0,
	"timestamp": 1614861228.1035924,
	"trace_id": "bb97c56f0b85da64"

}

# Extracting AI-generated code from the return value

For AI testing tasks , support is available for retrieving AI-generated code from third-party interfaces.Examples are as follows:

import requests

def get_ai_code():
    data = {
        'token': 'your minitest token',  # 需要换成你的token
        'group_en_id': 'group en id',   # 需要换成你的项目英文ID
        'full_info': 1,  # 注意full_info必须为1
        'plan_id': xxx,  # 这里换成你自己查询的任务ID
    }
    resp = requests.get('https://minitest.weixin.qq.com/thirdapi/plan', params=data)
    resp = resp.json()
    results = resp['data'].get('results')
    for each_result in results:
        minium_code = each_result.get('minium_ai_code')
        if minium_code:
          # minium_ai_example.py 可以换成你要下载的文件
            with open('minium_ai_example.py', 'w', encoding='utf8') as f:
                for line in minium_code:
                    f.write(line)
    return

# Remarks

The task part status code is as follows:

Tips: When the status code is greater than 10, the task is completed .If the number is greater than 10 and not 12, there are generally exceptions that can be considered unsuccessful.

• 1: In the line
• 2: In the test
• 11: Case not found
• 12: The test ends
• 15: Task Overtime

# Get a link to share the report

# Brief description

• Get a link to the task sharing report, please note that it is valid for 30 days

# Request URL

• https://minitest.weixin.qq.com/thirdapi/share_url

# How to request

• GET

# parameter

# Return an example

{
  "data":{
    "expired_time":"2022-07-06 17:21:49",
    "share_url":"xxx"
  },
  "msg":"ok",
  "rtn":0,
  "timestamp":1654507309.8952177,
  "trace_id":"5f7884d3953a2e18"
}

# Get the test results resource

# Brief description

• Get the test result resources, such as screenshots, logs, etc., and the interface returns the download link of the packaged zip file, which is classified by use case name + device id after decompression. Note: The response time of this interface is affected by the space occupied by the result of the task. The response time can be several seconds. Please increase the request timeout appropriately.

# Request URL

• https://minitest.weixin.qq.com/thirdapi/report/static_resource

# How to request

• GET

# parameter

# Return an example

{
  "data":{
	  "download_url": "https://minitest.weixin.qq.com/thirdapi/resource/xxxxxxxxxxxxxxxxxxxxxx.zip"
  },
  "msg": null,
  "rtn": 0,
  "timestamp": 1669293003.1537051,
  "trace_id": "b3052d8c5008588f"
}

# Cancel the test task

# Brief description

• Cancel tasks that are being tested with the following limitations:
  • Submit the creation task for a minute before attempting to cancel
  • Only tasks in "Create," "Queue," and "Test" support cancellation
  • In order to avoid waste of equipment resources, canceling tasks after five minutes of creation is not supported ( purchasing a private cloud project is not supported)

# Request URL

• https://minitest.weixin.qq.com/thirdapi/plan/cancel

# How to request

• POST

# parameter

# Return an example

{
  "data": null,
  "msg": "",
  "rtn": 0,
  "timestamp": 1669293003.1537051,
  "trace_id": "b3052d8c5008588f"
}

# Remarks

Please pay attention tortnreturn value is 0 ,If and only if the cancellation is successful** 0** , otherwise please pay attention tomsgfield content.

# Delete the test task

# Brief description

When deleting a test task, can only delete tasks that have run

The task being executed cannot be deleted. If you need to end the task, refer to the task cancellation interface above

# Request URL

• https://minitest.weixin.qq.com/thirdapi/plan/delete

# How to request

• POST

# parameter

# Return value

Pay attention to whether thertnreturn value is 0 ,If and only if the deletion is successful** 0** , otherwise please pay attention tomsgfield content.