功能描述

HTTP交互服务又称UbiHTTP,UbiHTTP允许在设备、网站和Web服务之间进行通信,无需在设备级上实现协议。您可以在UbiHTTP中指定操作,然后在其他Ubibot功能中触发这些操作,比如预警功能。

创建一个UbiHTTP请求

1.创建一个新的UbiHTTP请求。单击“数据工厂”->“HTTP交互”,然后单击新建UbiHTTP; 2.指定设置,并非每种类型的请求都需要所有设置。所有UbiHTTP请求都需要以下参数;

必选参数 描述
名字 为您的UbiHTTP请求输入一个唯一的名称
API密钥 自动为UbiHTTP请求生成的API密钥
网址 输入请求数据或写入数据的网站网址,以http://或https://开始
方法 选择访问网站网址所需的以下HTTP请求方法之一:GET,POST,PUT,DELETE。

针对您发出请求的性质,可以指定其他参数。例如,对需要身份验证的服务器的UbiHTTP请求需要用户名和密码。

可选参数 描述
HTTP 授权用户名 如果您的URL需要身份验证,请输入身份验证用户名以访问私人频道或网站。
HTTP身份验证密码 如果您的URL需要验证,请输入验证密码以访问私人频道或网站。
内容类型 输入请求内容的MIME或表单类型。例如,application/x-www-form-ubibot。
主机 如果您的UbiHTTP请求需要主机地址,请输入域名。例如,webapi.ubibot.cn。
内容 输入想包含在请求中的消息。如果出现以下字符,将被替换成具体字符值,例如:%%trigger_subject%% 后台构建的报警标题

eg: 预警提醒-编号为xxxx的设备(测试开关)已超出警戒范围

%%trigger_body%% 后台构建的报警消息完整内容

eg: 编号为xxxx的设备(测试开关)已超出预设定的警戒范围。

传感器:field1 (开关状态),报警瞬间值:1。(规则名:智能开关开启)。 本条预警触发记录的ID是:2692595。您可以进入管理控制台进行查看。

%%trigger_field%% 对应field名字

eg: field1 (开关状态)

%%channel_id%% 空间编号ID

eg: xxxx

%%name%% channel的名字

eg: 测试开关

%%trigger_type%% 触发类型,如果为recover则为恢复预警 仅恢复时返回

eg: recover

%%sampled_at%% 数据采集时间 (返回时间戳)

eg: 1603263103

%%rule_type%% 预警类型 (numeric-数据预警 | no_data_check-离线预警 | status_field-USB断电预警)

eg: numeric

%%rule_name%% 预警名称

eg: 智能开关开启

%%rule_condition%% 预警阈值

eg: 10

%%action_frequency%% (change_only-突变预警 | change_only_delayed-延迟突变预警 | always-持续预警 | always_delayed-延迟持续预警)

eg: change_only

%%frequency%% (当预警为延迟预警时所设置的延迟时间单位S)

eg: 120

%%criteria%% 预警关系

eg: >

%%trigger_id%% 预警ID

eg: 2692622

%%trigger%% 预警瞬间值

eg: 1

3.保存请求。通过添加预警功能并选择UbiHTTP,您的UbiHTTP可供将来使用。

触发UbiHTTP

使用GET或POST请求,通过设置预警规则触发UbiHTTP。

1. 单击进入“数据仓库”->“我的数据仓库”;
2. 选择要设置HTTP交互的设备->“预警规则”->“创建离线/数据/USB断电预警”;
3. 按照应用情景进行预警信息设置;
4. 报警方式选择“HTTP交互”->选择刚刚设置好的UbiHTTP请求名字;
5. 保存预警;

当设备的传感器检测值到达用户设定的阈值时,UbiHTTP 请求被触发。