检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建固件升级任务 典型场景 若需要对设备进行固件版本升级,第三方应用可调用此接口为多个设备创建固件升级任务,升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行固件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行固件版本升级,当前仅支持对NB-IoT
刷新设备密钥 典型场景 已在物联网平台注册的设备,若设备的唯一标识码发生变更(如更换设备等场景),第三方应用需要调用此接口在物联网平台更新设备的唯一标识,并重新绑定设备。 仅当设备处于离线状态时,才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的nodeId
查询设备影子 典型场景 若设备处于离线或异常状态时,第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方应用查询单个设备的设备影子信息
软件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了软件升级状态变更通知后(订阅的通知类型为swUpgradeStateChangeNotify),当设备进行软件升级,升级任务的状态发生变化时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级状态变更通知的第三方应用推送通知消息
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作,上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程,需要开发者先在物联网平台注册直连设备
绑定配置 接口功能 在设备绑定前配置平台的地址和端口。 接口描述 1 public static boolean setConfig(int key, String value); 接口所属类 BindConfig 参数说明 字段 必选/可选 类型 描述 key 必选 int 设备绑定的配置项
设备登录 接口功能 设备在第一次绑定后,或者在设备重启后需要进行登录的流程。 接口描述 1 public static boolean login(); 接口所属类 LoginService 接口返回值 返回值 描述 true 成功。 false 失败。 此返回值是调用接口的同步返回结果
修改设备信息 典型场景 第三方应用在物联网平台注册设备后,若设备的基本信息发生变更,也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息,包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 void modifyDeviceInfo(ModifyDeviceInforInDTO
设备信息变化通知 典型场景 第三方应用在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备信息变化通知的第三方应用推送通知消息
设备命令响应通知 典型场景 第三方应用在物联网平台订阅了设备命令响应通知后(订阅的通知类型为commandRsp),当平台向设备下发命令,并收到设备返回的命令响应消息(如命令执行成功或者执行失败,设备要向平台返回指定内容响应)时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备命令响应通知的第三方应用推送通知消息
查询单个设备信息 典型场景 已在物联网平台注册的设备,第三方应用若需要查看某个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据设备ID查询指定设备的详细信息,包括配置信息、状态信息、服务属性信息等
订阅平台业务数据 典型场景 第三方应用可在物联网平台订阅设备相关的业务数据,当物联网平台中设备的业务信息发生变化时(如设备注册、设备数据上报、设备状态变更等),平台会向第三方应用发送通知消息,通知其具体的变化信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备业务变更通知。
设备信息变化通知 典型场景 第三方应用在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备信息变化通知的第三方应用推送通知消息
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后(订阅的通知类型为deviceDataChanged),当设备上报单个服务属性数据时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
设备消息确认通知 典型场景 第三方应用在物联网平台订阅了设备消息确认通知后(订阅的通知类型为messageConfirm),当平台向设备下发命令,并收到设备返回的命令确认消息(如命令已送达、已执行等)时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备消息确认通知的第三方应用推送通知消息
删除设备模型通知 典型场景 第三方应用在物联网平台订阅了设备模型删除通知后(订阅的通知类型为deviceModelDeleted),在物联网平台上删除设备Profile文件时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备模型删除通知的第三方应用推送通知消息
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:平台收到命令后缓存起来
查询单个设备信息 典型场景 已在物联网平台注册的设备,第三方应用若需要查看某个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据设备ID查询指定设备的详细信息,包括配置信息、状态信息、服务属性信息等
批量设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据批量变化通知的第三方应用推送通知消息
设备登录 接口功能 设备在第一次绑定后,或者在设备重启后需要进行登录的流程。 接口描述 1 public static boolean login(); 接口所属类 LoginService 接口返回值 返回值 描述 true 成功。 false 失败。 此返回值是调用接口的同步返回结果