查询设备定时

更新时间：2023-07-25 05:58:00下载pdf

本文介绍查询设备定时的 API。

接口描述

查询执行设备定时任务的详细信息。

接口地址

GET: /v2.0/cloud/timer/device/{device_id}

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID。
timer_ids	String	query	false	定时任务 ID，多个用英文逗号隔开。
category	String	query	false	定时分类。

返回参数

参数名	类型	说明
result	List	返回结果。

result 说明

参数名	类型	说明
time_id	String	定时任务 ID。
alias_name	String	定时任务别名。
time	String	执行定时任务的时间。
timezone_id	String	时区 ID，比如 Asia/Shanghai。
date	String	执行定时任务的日期。
loops	String	如果请求失败，返回由 `0` 和 `1` 组成的七位数字。`0` 代表关闭，`1` 代表开启。例如，`0000001` 代表周日、周一、周⼆、周三、周四、周五定时任务关闭，周六定时任务开启。
functions	List	定时执行的指令。
enable	Boolean	是否已启用定时任务。 `true`：已启用。 `false`：已停用。

functions 说明

参数名	类型	说明
code	String	将要执⾏指令的 code。
value	object	将要执⾏指令的 value。

请求示例

GET: /v2.0/cloud/timer/device/6ccb7dc348af04ad****?timer_ids=1****

返回示例

{
    "tid": "dcae3f8bd1f811ed9aa2525400d49d82",
    "result": [
        {
            "date": "00000000",
            "functions": [
                {
                    "code": "switch_1",
                    "value": true
                }
            ],
            "loops": "1111111",
            "alias_name": "测试定时1-3",
            "timer_id": "1****",
            "timezone_id": "Asia/Shanghai",
            "time": "14:52"
        }
    ],
    "t": 1680510230386,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。