菜单

创建循环任务

使用说明

创建循环任务

请求说明

POST /api/v1/automation/addPlan

请求参数

参数	类型	必需	说明
template_id	string	是	模板ID
template_type	int	是	模板来源（1：官方模板，2：自定义模板）
name	string	是	名称
remark	string	否	备注
images	array	是	任务数据

images

参数	类型	必需	说明
image_id	string	是	云手机ID
start_at	string	是	开始时间
end_at	string	是	结束时间
execute_type	string	是	执行频率（1：间隔，2：每天, 3：每周，4：每月）
gap_time	int	否	间隔时间（execute_type为1必传）
execute_time	string	否	执行开始时间（execute_type为2、3、4必传）
execute_end_time	string	否	执行结束时间（execute_type为2、3、4且mode为2时必传）
mode	int	否	模式，1：单次执行 2：循环执行；（execute_type为2、3、4必传）
weeks	array	否	周天数（execute_type为3必传）
days	array	否	月天数（execute_type为4必传）
config	object	否	数据配置
config.{变量名}	object	条件必需	模板变量配置，对象键通常和内部 key 相同

config.{变量名}

参数	类型	必需	说明
key	string	是	模板变量名，例如 Search-Content。
value	string/array	是	变量值，当 key 为 file 时，需传入数组类型的 value
type	string	是	参数类型，例如：`file` 文件，`textarea` 批量文本，`boolean` 布尔型，`number` 数字，`string` 字符串，`excel` Excel 上传
required	bool	是	是否必填项， `true` 必填，`false` 非必填

请求示例

json 复制代码

{
    "template_id": "ncwlP",
    "template_type": "2",
    "name": "任务名称",
    "remark": "备注信息",
    "images": [
        {
            "image_id": "AIZ3k",
            "config": {
                "file": {                        // 变量名
                    "key": "file",               // 变量名
                    "value": [                   // 有效的图片地址 或 云盘文件ID (已上传到云盘的文件可通过文件列表获取ID)
                        "L1ZVt",                 // 云盘文件ID
                        "https://xxx/xxx.png"    // 有效的图片地址
                    ],
                    "type": "file",
                    "required": true
                },
                "text": {
                    "key": "text",
                    "value": "123\n456",
                    "type": "textarea",
                    "required": true
                },
                "bool": {
                    "key": "bool",
                    "value": "true",
                    "type": "boolean",
                    "required": true
                },
                "age": {
                    "key": "age",
                    "value": "18",
                    "type": "number",
                    "required": true
                },
                "name": {
                    "key": "name",
                    "value": "duoplus",
                    "type": "string",
                    "required": true
                },
                "email": {
                    "key": "email",
                    "value": "email1,email2",
                    "type": "excel",
                    "required": false
                },
                "password": {
                    "key": "password",
                    "value": "password1,passowrd2",
                    "type": "excel",
                    "required": false
                }
            },
            "start_at": "2025-12-11 17:38",
            "end_at": "2025-12-25 18:08",
            "execute_type": 4,
            "gap_time": 20,
            "execute_time": "15:11",
            "execute_end_time": "18:00",
            "mode": 2,
            "weeks":["1","2","3","4","5"],
            "days": ["10","15","20","25"]
        }
    ]
}

返回示例

json 复制代码

{
    "code": 200,
    "data": {
        "id": "xxxx"
    },
    "message": "Success"
}

上一个

创建定时任务

下一个

循环任务列表

最近修改: 2026-09-16Powered by

大纲