查询任务模板详情

根据任务模板编码查询完整模板配置。

接口基础信息

接口名称： 根据任务code查询任务模板
接口说明： 根据任务code查询任务模板
请求方式： POST
请求路径： remoteApi/taskModelByCode
是否需要登录： 否
是否需要权限： 是

请求参数

参数名	类型	是否必填	示例	说明
taskCode	String	是		任务编码

请求示例

{
  "taskCode": "2019672257034543104"
}

返回值

基础信息

字段 / 类型	说明与示例
`taskCode` `String`	任务编码示例：`1993623196131729408`
`taskName` `String`	任务名称示例：`只测红外`
`executeType` `Integer`	执行类型（1-立即，2-定期，3-周期，4-间隔执行）
`patrolType` `String`	巡视类型：1-例行；2-特殊；3-专项；4-自定义；示例：`1`
`pointCodes` `String`	巡检点codes（英文逗号分隔）示例：`a001_19,a001_21,a001_22`
`pointCount` `Integer`	巡检点数量示例：`3`
`dogCode` `String`	执行巡检的机器狗编码示例：`1`
`priority` `Integer`	优先级：1-最低，2，3，4-最高示例：`1`
`endAction` `String`	结束动作：1-自动充电，2-原地待命示例：`1`
`deviceLevel` `Integer`	设备等级：0-区域，1-间隔，2-主设备，3-点位，4-部件示例：`3`
`createTime` `String`	创建时间示例：`2025-11-26 18:09:44`
`isEnable` `String`	是否启用：0否，1是示例：`1`

定期执行

字段 / 类型	说明与示例
`fixedStartTime` `String`	定期任务开始时间yyyy-MM-dd HH:mm:ss

周期执行

字段 / 类型	说明与示例
`cycleMonth` `String`	周期（月）
`cycleWeek` `String`	周期（周）
`cycleExecuteTime` `String`	周期执行时间HH:mm:ss
`cycleStartTime` `String`	周期开始时间 yyyy-MM-dd HH:mm:ss
`cycleEndTime` `String`	周期结束时间 yyyy-MM-dd HH:mm:ss

间隔执行

字段 / 类型	说明与示例
`intervalNumber` `Integer`	间隔数量示例：`1`
`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

其他状态

字段 / 类型	说明与示例
`repeatable` `String`	是否可下发：0-否，1-是示例：`1`
`stationName` `String`	变电站名称示例：`云深处`
`planTimeContent` `String`	计划时间说明示例：`无执行计划`

返回示例

{
  "success": true,
  "code": 200,
  "msg": "操作成功",
  "data": {
    "taskCode": "2019672257034543104",
    "taskName": "zz_间隔",
    "executeType": 4,
    "patrolType": "1",
    "pointCodes": "A1_12",
    "pointCount": 1,
    "dogCode": "DOG2011258510273380352",
    "priority": 1,
    "endAction": "1",
    "deviceLevel": 3,
    "createTime": "2026-02-06 15:19:24",
    "isEnable": "1",
    "fixedStartTime": null,
    "cycleMonth": "",
    "cycleWeek": "",
    "cycleExecuteTime": null,
    "cycleStartTime": null,
    "cycleEndTime": null,
    "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",
    "repeatable": "1",
    "stationName": "xx站",
    "planTimeContent": "自2025-12-01 00:00:00至2026-01-03 00:00:00时间范围内,以16:27:59为开始时间,每隔2小时执行一次,不可用时间段为:2025-12-04 00:00:00-2026-01-06 23:59:59"
  }
}

错误码表

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