Appearance
定时接口
1、添加定时
POST接口
JSON格式 数据类型 "Content-Type": "application/json; charset=utf-8"
API: https://apis.bemfa.com/vb/delay/v1/addTime
参数 | 是否必须 | 类型 | 说明 |
---|---|---|---|
openID | 是 | 字符串 | 用户私钥 |
topicID | 是 | 字符串 | 主题值 |
time | 是 | 字符串 | 24小时制,格式22:30:21 |
type | 是 | 整型 | 1=MQTT设备,3=TCP设备 |
msg | 是 | 字符串 | 需要发送的消息 |
week | 否 | 整数数组 | 默认周一到周日全选,0~6,其中0表示周日 |
请求体示例:
{
"time":"22:30:21",
"openID":"4d9ec352e0376f2110a0c601a2857225",
"topicID":"fan003",
"type":1,
"msg":"on#2",
"week":[3,2,1,4,5]
}
正确返回:
{
"code": 0,
"msg": "success",
"data": {
"code": 0
}
}
请求示例:
2、获取设备定时列表
API: https://apis.bemfa.com/vb/delay/v1/timeList
参数 | 是否必须 | 类型 | 说明 |
---|---|---|---|
openID | 是 | 字符串类型 | 用户私钥 |
topicID | 是 | 字符串 | 主题值 |
time | 是 | 字符串 | 24小时制,格式22:30:21 |
type | 是 | 整型 | 1=MQTT设备,3=TCP设备 |
正确返回:
{
"code": 0,
"msg": "success",
"data": {
"data": [
{
"id": 46565,
"status": 1,
"time": "22:30:21",
"msg": "on#2",
"week": [
1
]
},
{
"id": 3246,
"status": 0,
"time": "03:30:24",
"msg": "off",
"week": [
0,
1,
2,
3,
4,
5,
6
]
}
]
}
}
参数说明
参数 | 类型 | 说明 |
---|---|---|
id | 整形 | 定时ID |
status | 状态 | 0禁用1启用 |
time | 字符串 | 定时时间 |
msg | 字符串 | 定时消息 |
week | 整数数组 | 星期,其中0表示星期日 |
3、禁用时间
POST接口
JSON格式 数据类型 "Content-Type": "application/json; charset=utf-8"
API: https://apis.bemfa.com/vb/delay/v1/disableTime
参数 | 是否必须 | 类型 | 说明 |
---|---|---|---|
id | 是 | 整型 | 时间ID,时间获取接口可获取 |
topicID | 是 | 字符串 | 主题值 |
type | 是 | 整型 | 1=MQTT设备,3=TCP设备 |
请求体示例:
{
"openID":"4d9ec352e0376f2110a0c601a2857225",
"topicID":"fan003",
"type":1,
"id":46565
}
正确返回:
{
"code": 0,
"msg": "success",
"data": {
"code": 0
}
}
4、启用时间
POST接口
JSON格式 数据类型 "Content-Type": "application/json; charset=utf-8"
API: https://apis.bemfa.com/vb/delay/v1/enableTime
参数 | 是否必须 | 类型 | 说明 |
---|---|---|---|
openID | 是 | 字符串类型 | 用户私钥 |
id | 是 | 整型 | 时间ID,时间获取接口可获取 |
topicID | 是 | 字符串 | 主题值 |
type | 是 | 整型 | 1=MQTT设备,3=TCP设备 |
请求体示例:
{
"openID":"4d9ec352e0376f2110a0c601a2857225",
"topicID":"fan003",
"type":1,
"id":46565
}
正确返回:
{
"code": 0,
"msg": "success",
"data": {
"code": 0
}
}
4、删除时间
POST接口
JSON格式 数据类型 "Content-Type": "application/json; charset=utf-8"
API: https://apis.bemfa.com/vb/delay/v1/deleteTime
参数 | 是否必须 | 类型 | 说明 |
---|---|---|---|
openID | 是 | 字符串类型 | 用户私钥 |
id | 是 | 整型 | 时间ID,时间获取接口可获取 |
topicID | 是 | 字符串 | 主题值 |
type | 是 | 整型 | 1=MQTT设备,3=TCP设备 |
请求体示例:
{
"openID":"4d9ec352e0376f2110a0c601a2857225",
"topicID":"fan003",
"type":1,
"id":46565
}
正确返回:
{
"code": 0,
"msg": "success",
"data": {
"code": 0
}
}