检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口说明 应用服务器在物联网平台订阅了固件升级结果通知后(订阅的通知类型为fwUpgradeResultNotify),当设备的固件升级任务执行完成时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后(订阅的通知类型为bindDevice),当设备接入并绑定物联网平台时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
示设备验证码不会失效(建议填写为“0”)。 默认值:0(默认值可配置,具体配置值请咨询物联网平台运维人员) verifyCode 可选 String(256) body 设备验证码,全局唯一,建议与nodeId设置成相同值。若在请求中指定verifyCode,则响应中返回请求中指
设备服务能力删除通知 接口说明 应用服务器在物联网平台订阅了设备服务能力删除通知后(订阅的通知类型为deviceCapabilitiesDeleted),在物联网平台上删除设备Profile文件时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI
Demo代码是调用SDK接口的样例代码,包括初始化及各个接口调用,仅供开发者参考。 SDK提供Python方法调用物联网平台的API接口与平台通信。 消息推送回调使用Python代码实现回调接口,供平台推送消息给应用服务器时调用,应用通过继承PushMessageReceiver类并重写类中的方法接收推送消息的内容。
设备服务能力增加通知 接口说明 应用服务器在物联网平台订阅了设备服务能力增加通知后(订阅的通知类型为deviceCapabilitiesAdded),在物联网平台上新增设备Profile文件时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI
求。开发包括如下几个关键阶段。 应用服务器开发阶段 操作指引 调用API接口或者集成SDK 应用开发者通过调用API接口或者集成SDK调用物联网平台的能力进行应用服务器的开发。可参考表1选择合适的开发方式。 开发接收设备数据的接口 应用服务器需开发接收数据对应的接口(对应订阅管理
软件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了软件升级状态变更通知后(订阅的通知类型为swUpgradeStateChangeNotify),当设备进行软件升级,升级任务的状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(PENDING状态),此时应用服务器可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
接口说明 应用服务器在物联网平台订阅了设备数据变化通知后(订阅的通知类型为deviceDataChanged),当设备上报单个服务属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
设备服务能力变化通知 接口说明 应用服务器在物联网平台订阅了设备服务能力变化通知后(订阅的通知类型为deviceCapabilitiesChanged),在物联网平台上设备Profile文件中的服务和属性被修改时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
固件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了固件升级状态变更通知后(订阅的通知类型为fwUpgradeStateChangeNotify),当设备进行固件升级,升级任务的状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
设备影子状态变更通知 接口说明 应用服务器在物联网平台订阅了设备影子状态变更通知后(订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged),当平台中的设备影子向设备同步数据成功或失败时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
由于业务应用所在的网络不同,业务应用的访问地址也不同。 业务应用部署在公网时,业务应用的访问地址就是业务应用的公网IP:端口(或域名:端口)。 业务应用部署在局域网时,需要在业务应用配置网络穿透,生成业务应用的公网访问地址,具体配置自行从网上获取网络穿透工具的配置步骤。 不同通知类型的订阅,回调地址可以相同也可以不同,根据业务需求自定义。
接口说明 应用服务器在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令,且当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。
pass:必须与4中设置的私钥密码保持一致。 days:代表证书有效期。 执行如下命令生成应用服务器端私钥文件。 openssl genrsa -passout pass:123456 -aes256 -out server_private.key 2048 执行如下命令生成应用服务器端csr文件,用于生成服务端证书。
true。 业务接口调用方法 设置好NorthApiClient实例后才能调用其他业务接口。以如下几个接口为例说明如何调用业务接口。 关于哪些参数需要设置,请查看《应用侧JAVA SDK API参考》。对于可选参数,如果业务不需要,可以不设置或者设置为null。 鉴权 1 2 3
设备上报了命令执行结果,但是命令状态未切换为成功? 在开发中心的“设备管理 > 设备日志”中,打开日志功能。在设备上报命令执行结果后: 如果没有日志打印,说明消息没有到达平台。请检查网络侧和设备侧。 如果有日志打印,并且日志中没有错误提示,则可能插件中mid字段的配置有误。mid的使用方法请参考命令执行结果的编解码插件在线开发。
物联网平台采用HTTPS协议向应用服务器进行消息推送时,物联网平台需要校验应用服务器的真实性,需要在物联网平台上加载CA证书,该证书由应用服务器侧提供(调测时可自行制作调测证书,商用时建议更换为商用证书,否则会带来安全风险)。 推送机制:物联网平台向应用服务器推送消息后,如果应用服务器接收消息成功,会向物联网平台返回200