检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备第一次接入物联网平台时需要进行绑定操作,上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程,需要开发者先在物联网平台注册直连设备,之后在设备上发起绑定操作,将设备绑定到物联
查询设备影子 接口说明 若设备处于离线或异常状态时,应用服务器无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。应用服务器可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 注意事项 当前仅使用
物联网平台订阅推送是否具有重推机制? 物联网平台具有重推机制,机制如下: 物联网平台向应用服务器推送消息后,如果应用服务器接收消息成功,会向物联网平台返回200 OK响应码。如果应用服务器无响应(响应超时时长15秒)或者应用服务器向物联网平台返回501、502、503、504响应码,表示消息推送失败
接口说明 应用服务器在物联网平台订阅了设备激活通知后(订阅的资源为device,事件为activate),当设备首次接入物联网平台并激活时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设备激活通知中的callbackUrl决定
查询设备影子历史数据 接口说明 应用服务器通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当应用服务器需要查看设备影子的历史配置记录时,可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/shadow/v1.5.0/deviceDesiredHistory
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后(资源为device.status,事件为update),当物联网平台中的设备状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI
推送的流程如下: 应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知(携带回调地址和通知类型),物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。 设备上报数据给物联网平台。 物联网平台根据订阅时设置的回调地址,将设备数据主动推送给业务应用。
参考鉴权接口文档,调测物联网平台鉴权接口。 配置“鉴权”接口的HTTP方法、URL。 参数 取值 HTTP方法 POST URL https://server:port/iocm/app/sec/v1.1.0/login 其中server:port为获取应用接入信息时获取的域名和端口。不能通过域名接入的设备,此处填写从2中获取的IP地址。
回调路径已在SDK中设置好了,所以在订阅时要注意设置对应的回调地址。回调的IP地址则是服务器的地址,需要是公网地址。Demo工程的回调端口配置在src\main\resource\application.properties中: 1 2 #specify the port of the
批量创建设备命令 应用服务器若需要向多个设备下发相同的设备命令时,可调用此接口向批量设备下发命令。 此功能通过创建批量任务接口向设备下发批量任务实现,“taskType”参数设置为“DeviceCmd”时,为向批量设备下发命令。 父主题: 命令下发
为了更直观地查看应用程序发送的消息及物联网平台的响应消息,以下方法使用了Eclipse的断点调试方法。 在最终发出http/https消息的代码处设置断点。例如:在样例代码“HttpsUtil.java”中的“executeHttpRequest”方法设置3个断点(请根据您代码的实际情况打断点)。
如何获取证书? 请按照以下途径获取: 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时,制作调测证书或购买证书。 父主题: 订阅推送(联通用户专用)
传输请求的协议,当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器地址,为“host:port”格式,host为服务器的访问域名或IP,port为服务器的访问端口,您可以参考平台对接信息获取应用的接入地址和端口信息。 例如设备管理服务在“华北-北京四”区域的应用对接地址为“iot-api
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容
批量查询订阅 接口说明 应用服务器可在物联网平台上创建多个订阅,以订阅不同类型的设备变更通知。应用服务器若需要查看本应用下所有订阅配置,或者查看某种订阅类型下的所有订阅配置,可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions
如何获取证书? 请按照以下途径获取: 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时,制作调测证书或购买证书。 父主题: 应用集成(联通用户专用)
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接
回调路径已在SDK中设置好了,所以在订阅时要注意设置对应的回调地址。回调的IP地址则是服务器的地址,需要是公网地址,端口自行配置。 回调证书制作 本章节以自签名证书为例。如果是使用商用证书,请直接向CA机构申请。 注:每个步骤的创建证书请求中的配置,请自行设置。“Common Name
接口说明 应用服务器在物联网平台订阅了注册设备通知后(订阅的通知类型为deviceAdded),当应用服务器通过“注册设备”接口在平台注册设备时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
查询订阅 接口说明 应用服务器可调用此接口查询物联网平台中指定订阅的配置信息。 URI 请求方法 GET URI /v5/iot/{project_id}/subscriptions/{subscription_id} 传输协议 HTTPS 请求参数 名称 必选/可选 类型 位置