【版本】
当前版本号v20220430
版本 | 修改说明 |
---|---|
v20220430 | 初始化版本 |
任务6.1 - 物联网云平台项目新增开放API——增加设备消息
【任务目的】
- 掌握物联网云平台项目开放API的实现
【任务环境】
- 内存:至少4G
- 硬盘:至少空余40G
- 操作系统: Windows 系统。
【任务资源】
【任务说明】
接收设备消息功能主要目的在物联网云平台注册的设备,可以接收并保存设备通过 HTTP 发送的消息。
本次设计的物联网云平台增加设备消息的开放API
- URL:http://localhost:8098/devicemsg_add
- 调用 HTTP 方法:POST
- 请求参数:
参数类型 | 参数名 | 说明 | 数据类型或示例 |
---|---|---|---|
URL参数 | iotId | 设备物联网云平台ID | 字符串 |
URL参数 | secret | 设备密钥 | 字符串 |
BODY | msg | 发送的设备消息,其中msg字段是发送的自定义消息;iotId是物联网云平台ID;tag是自定义消息类型 | JSON格式 -> {“iotId”: “设备物联网云平台ID”,“msg”: {},“tag”: “消息类型”} |
- 创建成功的响应数据:
{
"errcode":"0",
"errmsg":"发送成功",
"data":null
}
- 创建失败的响应数据:
{
"errcode":"1001",
"errmsg":"发送失败",
"data":null
}
- 设备端调用此开放API 可以把设备消息保存到
device_msg
表。
【任务步骤】
- 打开
iot-cloud-training-init
项目,完善DeviceMsgController.addDeviceMsg
方法,实现以上实验要求。
提示:可以完善并调用
DeviceMsgService.save
方法。
【任务名称】实验6.2 - 表情温度计项目调用开放API实现保存新增设备消息到物联网云平台
【任务目的】
- 掌握调用物联网云平台项目开放API的实现
【任务环境】
- 内存:至少4G
- 硬盘:至少空余40G
- 操作系统: Windows 系统。
【任务资源】
【任务要求】
在表情温度计配置页面配置了设备的物联网云平台设备ID(IoT ID)和设备密钥,点击首页的
发送温度消息
按钮可以发送温度和时间到物联网云平台并保存。以下为发送的温度消息的一个实例,其中temp是表情温度计当前温度,time是发送消息的时间戳。
{
"iotId": "B2f66kHjuo3rhFlq",
"msg": {"temp":10,"time":1651334139956},
"tag": "temp"
}
【任务效果】
- 在表情温度计配置页面,注册设备获取物联网云平台设备ID(IoT ID)和设备密钥。在首页点击
发送温度消息
按钮。
【任务步骤】
- 打开
iot-thermometer-init
项目,完善TempController.sendDeviceMsg
方法,完成调用物联网云平台新增设备消息API。
提示:可以调用
HttpService.sendDeviceMsg()
方法,具体调用方法可以参考实验2.3。