检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK Demo总体架构 Demo代码是调用SDK接口的样例代码,包括初始化及各个接口调用,仅供开发者参考。 SDK提供JAVA方法调用物联网平台的API接口与平台通信。
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。
更新设备状态 接口功能 通过该接口更新设备的状态信息,包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理,当直连设备连接断开则表示设备离线,当直连设备连接或重连成功,则表示设备上线,无需通过该接口进行刷新。
更新设备状态 接口功能 通过该接口更新设备的状态信息,包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理,当直连设备连接断开则表示设备离线,当直连设备连接或重连成功,则表示设备上线,无需通过该接口进行刷新。
注册设备(验证码方式) 接口说明 在设备接入物联网平台前,应用服务器需要调用此接口在物联网平台注册设备,并设置设备的唯一标识(如IMEI)。在设备接入物联网平台时携带设备唯一标识,完成设备的接入认证。
查询订阅列表 接口说明 应用服务器可调用此接口查询物联网平台中的订阅配置信息列表。
接口功能 支持第三方应用在物联网平台根据版本包ID删除指定的版本包文件,在调用该接口前需要通过“查询版本包列表”接口查询获得要删除 接口描述 1 def deleteUpgradePackage(self, fileId, accessToken) 参数说明 参数 必选/可选 类型
设备登录 接口功能 设备在第一次绑定后,或者在设备重启后需要进行登录的流程。 接口描述 1 public static boolean login(); 接口所属类 LoginService 接口返回值 返回值 描述 true 成功。 false 失败。
接口功能 支持第三方应用在物联网平台根据版本包ID删除指定的版本包文件,在调用该接口前需要通过“查询版本包列表”接口查询获得要删除 接口描述 void deleteUpgradePackage(String fileId, String accessToken) throws NorthApiException
删除子设备 若子设备不再需要接入物联网平台,应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现,具体删除子设备命令需网关提前实现(即网关收到什么命令会触发删除子设备的流程),并已在设备的Profile文件中定义。
修改订阅 接口说明 应用服务器可调用此接口修改物联网平台中的指定订阅配置,当前仅支持修改订阅回调地址(callbackurl)。
接口功能 支持第三方应用在物联网平台根据版本包ID查询指定版本包信息,在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。
接口描述 1 QueryUpgradePackageOutDTO queryUpgradePackage(String fileId, String accessToken) throws NorthApiException 参数说明 参数 必选/可选 类型 位置 描述 fileId
删除单个订阅 接口说明 应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时,可调用此接口删除指定的订阅配置,取消订阅。
接口描述 1 HW_INT IOTA_Login(); 接口返回值 参见函数标准返回值 此返回值是调用接口的同步返回结果,返回0只是说明接口调用成功,并不说明登录成功,登录成功需要收到IOTA_TOPIC_CONNECTED_NTY广播。
添加设备 接口功能 当有新设备接入网关后,通过调用设备添加接口将非直连设备接入物联网平台,并且获得平台分配的唯一设备逻辑ID。
本文档以Postman为例,模拟应用服务器以HTTPS协议接入物联网平台,调测以下API接口: “鉴权”接口 “注册设备”接口 “修改设备信息”接口 “删除设备”接口 配置Postman 导入Postman环境变量。
接口描述 1 void startRefreshTokenTimer() throws NorthApiException 接口所属类 Authentication 参数说明 appId和secret直接使用NorthApiClient类方法成员变量的Clientinfo类方法中的值
resource-path 资源路径,即API访问路径。从具体API的URI信息处获取,例如鉴权接口的resource-path为“/iocm/app/sec/v1.1.0/login”。
查询指定设备组成员 接口说明 应用服务器若需要查看某个设备组中的设备成员分布情况,可调用此接口查询指定设备组的设备成员列表信息。