新增任务模板

创建包含机器人、地图、点位和调度配置的任务模板。

接口基础信息

接口名称： 新增任务模板
接口说明： 新增任务模板，但是不下发任务
请求方式： POST
请求路径： remoteApi/onlySaveTaskModel
是否需要登录： 否
是否需要权限： 是

请求参数

基础参数

taskName · String · 必填

任务名称
示例：红外巡检任务
patrolType · String · 选填

巡检类型：1-例行；2-特殊；3-专项；4-自定义
示例：1
executeType · Integer · 选填

执行类型：1-立即执行；2-定期执行；3-周期执行；4-间隔执行
示例：1
pointCodes · String · 必填

所有巡检点code（逗号分隔）
示例：a001_1,a001_2
priority · Integer · 选填

优先级：1-最低，2，3，4-最高
endAction · String · 必填

结束动作：1-自动充电，2-原地待命
示例：1
deviceLevel · Integer · 选填

设备等级：0-区域，1-间隔，2-主设备，3-点位，4-部件
示例：3
isEnable · String · 选填

是否启用：0-否，1-是
示例：1

定期执行

fixedStartTime · String · 选填

定期开始时间（executeType=2 时使用） yyyy-MM-dd HH:mm:ss

周期执行

cycleMonth · String · 选填

按月周期：多个用逗号分割
示例：1,2,5
cycleWeek · String · 选填

按周周期：多个用逗号分割
示例：1,3,5
cycleExecuteTime · String · 选填

周期执行时间（HH:mm:ss）
cycleStartTime · String · 选填

周期开始时间yyyy-MM-dd HH:mm:ss
cycleEndTime · String · 选填

周期结束时间yyyy-MM-dd HH:mm:ss

间隔执行

intervalNumber · Integer · 选填

周期间隔数量
示例：2
intervalType · Integer · 选填

周期间隔类型：1-小时，2-天，3-分钟
示例：1
intervalExecuteTime · String · 选填

间隔执行时间（HH:mm:ss）
intervalStartTime · String · 选填

间隔开始时间 yyyy-MM-dd HH:mm:ss
intervalEndTime · String · 选填

间隔结束时间 yyyy-MM-dd HH:mm:ss

不可用时间

invalidStartTime · String · 选填

不可用开始时间yyyy-MM-dd HH:mm:ss
invalidEndTime · String · 选填

不可用结束时间yyyy-MM-dd HH:mm:ss
invalidDailyStartTime · String · 选填

每天不可用开始时间HH:mm:ss
invalidDailyEndTime · String · 选填

每天不可用结束时间HH:mm:ss

请求示例

参数为空时，计算签名 sign 时不要将该参数拼接进字符串。

例行巡视

{
  "taskName": "zz_例行巡视1",
  "patrolType": "1",
  "executeType": null,
  "pointCodes": "a001_16,a001_20",
  "priority": "1",
  "endAction": "1",
  "deviceLevel": "3",
  "isEnable": "1",
  "fixedStartTime": "",
  "cycleMonth": "",
  "cycleWeek": "",
  "cycleStartTime": "",
  "cycleEndTime": "",
  "intervalNumber": null,
  "intervalType": null,
  "intervalStartTime": "",
  "intervalEndTime": "",
  "invalidStartTime": "",
  "invalidEndTime": "",
  "invalidDailyStartTime": "",
  "invalidDailyEndTime": ""
}

定时巡视

{
  "taskName": "zz_例行巡视——定时",
  "patrolType": "1",
  "executeType": 2,
  "pointCodes": "a001_16",
  "priority": "1",
  "endAction": "1",
  "deviceLevel": "3",
  "isEnable": "1",
  "fixedStartTime": "2025-12-02 16:00:00",
  "cycleMonth": "",
  "cycleWeek": "",
  "cycleStartTime": "",
  "cycleEndTime": "",
  "intervalNumber": null,
  "intervalType": null,
  "intervalStartTime": "",
  "intervalEndTime": "",
  "invalidStartTime": "2026-01-01 00:00:00",
  "invalidEndTime": "2026-01-02 23:59:59",
  "invalidDailyStartTime": "",
  "invalidDailyEndTime": ""
}

周期巡视

{
  "taskName": "zz_周期",
  "patrolType": "1",
  "executeType": 3,
  "pointCodes": "a001_16",
  "priority": "1",
  "endAction": "1",
  "deviceLevel": "3",
  "isEnable": "1",
  "fixedStartTime": "",
  "cycleMonth": "12,1",
  "cycleWeek": "2,3,4",
  "cycleExecuteTime": "16:00:27",
  "cycleStartTime": "2025-12-01 00:00:00",
  "cycleEndTime": "2026-01-03 00:00:00",
  "intervalNumber": null,
  "intervalType": null,
  "intervalStartTime": "",
  "intervalEndTime": "",
  "invalidStartTime": "2025-12-04 00:00:00",
  "invalidEndTime": "2026-01-05 23:59:59",
  "invalidDailyStartTime": "",
  "invalidDailyEndTime": ""
}

间隔巡视

{
  "taskName": "zz_间隔",
  "patrolType": "1",
  "executeType": 4,
  "pointCodes": "a001_16,a001_17,a001_20",
  "priority": "1",
  "endAction": "1",
  "deviceLevel": "3",
  "isEnable": "1",
  "fixedStartTime": "",
  "cycleMonth": "",
  "cycleWeek": "",
  "cycleStartTime": "",
  "cycleEndTime": "",
  "intervalNumber": "2",
  "intervalType": 1,
  "intervalExecuteTime": "16:27:59",
  "intervalStartTime": "2025-12-01 00:00:00",
  "intervalEndTime": "2026-01-03 00:00:00",
  "invalidStartTime": "2025-12-04 00:00:00",
  "invalidEndTime": "2026-01-06 23:59:59",
  "invalidDailyStartTime": "19:30:16",
  "invalidDailyEndTime": "23:28:25"
}

返回值

字段	类型	示例	说明
code	Integer	200	状态码
success	Boolean	true	返回是否成功
msg	String	success	返回信息

返回示例

{
  "success": true,
  "code": 200,
  "msg": "操作成功",
  "data": null
}

错误码表

错误码	描述
400	参数错误
401	未授权
403	没有访问权限
404	找不到资源
500	服务器内部错误