检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK使用说明(联通用户专用) 非联通用户请查看设备接入服务。 SDK Demo总体架构 Demo代码是调用SDK接口的样例代码,包括初始化及各个接口调用,仅供开发者参考。 SDK提供JAVA方法调用物联网平台的API接口与平台通信。 消息推送回调使用JAVA代码实现回调接口,供
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,第三方应用通过调用此接口,获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken。
批量删除订阅 典型场景 第三方应用若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,第三方应用通过调用此接口,获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken。
上报设备数据 接口功能 当直连设备(网关)有数据需要上报或者非直连设备上报数据到网关时,网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的pcDeviceId、pcRequstId和pcServiceId由SDK组装为消息的header;pcServic
批量删除订阅 典型场景 第三方应用若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。
删除设备组 接口说明 若因分组变更,应用服务器不再需要使用某个设备组,且不想在物联网平台上继续保存该设备组信息时,可调用此接口在物联网平台删除指定设备组。 URI 请求方法 DELETE URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId}
查询设备组详情 典型场景 第三方应用可调用此接口查询当前已创建的所有设备组列表信息,以了解当前设备组的分组和使用情况。 接口功能 支持第三方应用在物联网平台查询已创建的所有设备组信息。 接口描述 1 def queryDeviceGroups(self, qdgInDTO, accessToken)
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台。
上报设备数据 接口功能 当直连设备(网关)有数据需要上报或者非直连设备上报数据到网关时,网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的deviceId,requstId和serviceId由SDK组装为消息的header;servicePropert
查询指定设备组 典型场景 第三方应用若需要查看某个设备组的信息,以了解该设备组的使用情况,可调用此接口查询指定设备组的信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组的信息。 接口描述 1 def querySingleDeviceGroup(self, devGroupId
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组,第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 def deleteDevicesFromGroup(self, dgwdlDTO, accessAppId
查询指定设备组 典型场景 第三方应用若需要查看某个设备组的信息,以了解该设备组的使用情况,可调用此接口查询指定设备组的信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组的信息。 接口描述 1 QuerySingleDeviceGroupOutDTO quer
刷新token 接口说明 应用服务器通过鉴权接口获取到的accessToken是有效时间的,在accessToken快过期时,应用服务器通过调用此接口,获取新的accessToken。 URI 请求方法 POST URI /iocm/app/sec/v1.1.0/refreshToken
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组,第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 void deleteDevicesFromGroup(DeviceGroupWithDeviceListDTO
查询指定设备组 接口说明 应用服务器若需要查看某个设备组的信息,以了解该设备组的使用情况,可调用此接口查询指定设备组的信息。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议 HTTPS 请求参数
删除设备 典型场景 已在物联网平台注册的设备,若不再需要接入平台时,第三方应用可调用此接口在物联网平台删除设备。后续若设备要再次接入平台,第三方应用需要在物联网平台重新注册设备。 接口功能 支持第三方应用在物联网平台删除已注册的设备,使设备无法再接入平台。 接口描述 1 void
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台。
删除设备 典型场景 已在物联网平台注册的设备,若不再需要接入平台时,第三方应用可调用此接口在物联网平台删除设备。后续若设备要再次接入平台,第三方应用需要在物联网平台重新注册设备。 接口功能 支持第三方应用在物联网平台删除已注册的设备,使设备无法再接入平台。 接口描述 1 def
鉴权 接口说明 应用服务器首次访问物联网平台的开放API时,需调用此接口完成认证鉴权,获取accessToken。 注意事项 鉴权接口是调用其他API的前提,除了调用鉴权接口,其他接口调用都需要在request header中携带参数app_key和Authorization。a