NB-IoT物联网套件 产品介绍 快速入门 用户指南 设备开发指南 应用开发指南 NB设备远程升级 最佳实践 常见问题 服务协议 更新日志

新增触发器

请求方式:POST

URL: http(s)://api.heclouds.com/triggers

我只想看示例!!!

http请求参数

参数名称格式是否必须说明
titlestring触发器名称
ds_idstring可选,数据流名称,数据流名称,由{obj_id}_{obj_inst_id}_{res_id}组成
dev_idsarray-string可选,设备ID
ds_uuidsarray-string可选,数据流uuid
urlstring告警通知地址
typestring触发条件,见type说明列表
threshold触发条件门限值,与type配合使用,见type说明列表
参数说明
1、触发器的含义是:当指定范围内的数据点满足触发条件的要求时,会向url参数指定的地址发送post请求;
2、触发器有三种工作触发模式
   1) 在请求参数中单独指定了ds_id,不包括其他参数,那么当前项目下所有设备的数据流中数据流名称符合ds_id的
数据都会进入触发判断逻辑;
   2) 在请求参数中单独指定了ds_uuids数组,那么只有这些指定的数据流会进入触发判断逻辑;
   3) 在请求参数中指定了ds_id和dev_ids,那么只有这些指定的设备的数据流会进入触发判断逻辑。
type说明列表
type说明
>threshold必须为数值
<threshold必须为数值
>=threshold必须为数值
<=< td="">threshold必须为数值
inoutthreshold设置为{"lolmt":40,"uplmt":52},表示数据值进入或离开闭区间[40,52]时触发
changethreshold参数不用传递;当上传的值有改变时触发告警
frozenthreshold为数值,指定多少秒内未上报数据触发告警,同时被监控对象进入frozen状态
livethreshold为数值,指定多少秒后上报数据触发告警

返回参数

参数名称格式说明
errnoint调用错误码,为0表示调用成功
error string错误描述,为"succ"表示调用成功
datajson接口调用成功之后返回的设备相关信息,见data描述表
data描述表
参数名称格式说明
trigger_idint触发器ID

请求头部示例

POST http://api.heclouds.com/triggers HTTP/1.1
api-key: YHC**************VqKA=

请求参数示例

{
    "title": "trigger",
    "ds_id": "gps",
    "url": "http://aoic.choqf.com",
    "type": ">",
    "threshold": 100
}

返回示例

{
    "errno":0,
    "data": {
        "trigger_id":123809
    },
    "error":"succ"
}

触发数据示例

{
    "trigger": {
        "id": 123809,
        "threshold": 9.0,
        "type": ">"
    },
    "current_data": [{
            "dev_id": "2656",
            "ds_id": "gps",
            "ds_uuid": "FWEF-ZFW-ZFW-ZFWW",
            "at": "2009-09-07T12:16:02.001403Z",
            "value": 100
        }
    ]
}

< 查询设备历史命令

更新触发器 >

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “