检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
承上启下的中间部分,向应用服务器开放API接口,向各种协议的设备提供API对接。为了提供更加丰富的设备管理能力,物联网平台需要理解接入设备具备的能力以及设备上报数据的格式,因此,您需要在控制台上完成产品模型和插件的开发。 产品模型是用来描述设备能力的文件,通过JSON的格式定义了
用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别,请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。 Topic
配置完Postman后,模拟应用服务器以HTTPS协议接入物联网平台,调测以下API接口: “获取IAM用户Token”接口 “查询IAM用户可以访问的项目列表”接口 “创建产品”接口 “查询产品”接口 “创建设备”接口 “查询设备”接口 进阶体验 按照本页面的指导,使用Postman模拟应用服务
设备属性上报 接口说明 用于设备按产品模型中定义的格式将属性数据上报给平台。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/properties/report 传输协议 HTTPS 请求参数 名称 必选 类型 位置 说明 access_token
ping:心跳的上行消息。 pong:平台回复心跳的响应。 tunnel_service_type String 参数说明: 隧道通信对应的业务类型。 取值范围: ssh。当前支持的业务类型为"ssh"。 request_id String 参数说明: 不同数据类型的会话ID。 约束限制:
功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系,请查看网关与子设备。 属性上报和消息上报的区别,请查看消息通信说明。 网关批量设备属性上报,单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个,建议分不同批次进行上报。
网关设备上报时,子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id,否则将请求失败。 直连设备上报时,object_device_id需与Topic中的device_id一致。 若为空则默认该参数与Topic中的device_id一致。 services 可选 List<ServiceEvent>
网关更新子设备状态响应 网关新增子设备请求 网关新增子设备请求响应 网关删除子设备请求 网关删除子设备请求响应 父主题: 设备侧MQTT/MQTTS接口参考
网关设备上报时,子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id,否则将请求失败。 直连设备上报时,object_device_id需与Topic中的device_id一致。 若为空则默认该参数与Topic中的device_id一致。 services 可选 List<ServiceEvent>
可通过Topic实现消息的发送和接收。 以$oc开头的topic是IoTDA预置的系统topic。您可以在允许的情况下订阅和发布到这些系统预置的Topic;具体Topic列表和功能说明可参考Topic定义。 您可以创建非$oc 开头的topic进行自定义消息的发送和接收。 使用限制
Object 参数解释: 设备命令的执行参数,具体字段在设备关联的产品模型中定义。 上行响应参数说明 命令应答的json格式,具体字段在设备关联的产品模型中定义。 字段名 必选/可选 类型 参数描述 result_code 可选 Integer 参数解释: 标识命令的执行结果,0表示成功,其
用于平台设置设备属性。设备的产品模型中定义了平台可向设备设置的属性,平台可调用此修改设备属性接口设置指定设备的属性数据。设备收到属性设置请求后,需要将执行结果返回给平台,如果设备没回响应平台会认为属性设置请求执行超时。 低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JS
查询设备隧道 功能介绍 用户可通过该接口查询某项目中的某个设备隧道,查看该设备隧道的信息与连接情况。应用服务器可调用此接口向平台查询设备隧道建立情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能,请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET /v
网关设备上报时,子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id,否则将请求失败。 直连设备上报时,object_device_id需与Topic中的device_id一致。 若为空则默认该参数与Topic中的device_id一致。 services 可选 List<ServiceEvent>
网关设备上报时,子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id,否则将请求失败。 直连设备上报时,object_device_id需与Topic中的device_id一致。 若为空则默认该参数与Topic中的device_id一致。 services 可选 List<ServiceEvent>
间server_recv_time 后,向设备发送时间server_send_time 。 例如,设备收到的设备侧时间为device_recv_time ,则设备计算自己的准确时间为: (server_recv_time + server_send_time + device_recv_time
查询设备所有隧道 功能介绍 用户可通过该接口查询某项目下的所有设备隧道,以实现对设备管理。应用服务器可通过此接口向平台查询设备隧道建立的情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能,请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET /v5/i
设备上报日志内容 Topic 上行: $oc/devices/{device_id}/sys/events/up 接口功能 日志收集开关开启时设备使用该接口向平台上报日志内容,最大不超过1MB。 参数说明 字段名 必选/可选 类型 参数描述 services 可选 List<ServiceEvent>
网关上报子设备属性 接口说明 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报最多50个子设备的属性数据。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/gateway/sub-devices/properties/report
服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明:实例ID。物理多租下各实例的唯一标识,建议携带该参数,在使