检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口说明 应用服务器通过物联网平台创建设备命令时,如果设置了callbackurl回调地址,当命令状态变化时(执行失败,执行成功,超时,发送,已送达),平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器下发命
含错误码时,将该异常的内容通过本方法返回。 SSLConfig类方法 用于设置证书路径及密码。主要方法(省略get方法)如下: 方法 说明 public String setSelfCertPath(String selfCertPath) 设置客户端的证书位置的绝对路径。 public
查询规则列表 接口说明 应用服务器可调用此接口查询物联网平台中设置的规则列表。 调试 您可以在API Explorer中直接运行调试该接口。 URI 请求方法 GET URI /v5/iot/{project_id}/rules 传输协议 HTTPS 请求参数 名称 必选/可选 类型
接口说明 应用服务器在物联网平台订阅了设备消息上报通知后(订阅的资源为device.message,事件为report),当设备上报消息数据时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设
接口说明 应用服务器在物联网平台订阅了设备属性变化通知后(订阅的资源为device.data,事件为update),当设备上属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设备属性变化通知的callbackUrl决定
设备消息状态变更通知 接口说明 应用服务器在物联网平台订阅了消息状态变更通知后(订阅的资源为device.message.status,事件为update),当消息状态变更时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI
批量任务状态变更通知 接口说明 应用服务器在物联网平台订阅了批量任务状态变更通知后(订阅的资源为batchtask.status,事件为update),当批量任务状态变更时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI
pem)、应用服务器证书(server.cer/server.crt/server.pem)和私钥文件(server_private.key)。其中CA证书用于加载到物联网平台,应用服务器证书和私钥文件用于加载到应用服务器。 加载证书 物联网平台采用HTTPS协议向应用服务器推送消息时
headers, payload, clientInfo) 所有接口最终调用的方法,根据传入的参数不同,最后返回的数据不同。 Clientinfo类 用于设置对接的基本信息。主要方法如下: 方法 说明 platformIp 平台的IP。 platformPort 平台的端口,如“8743”。
物联网平台订阅推送是否具有重推机制? 物联网平台具有重推机制,机制如下: 物联网平台向应用服务器推送消息后,如果应用服务器接收消息成功,会向物联网平台返回200 OK响应码。如果应用服务器无响应(响应超时时长15秒)或者应用服务器向物联网平台返回501、502、503、504响应码,表示消息推送失败
接口说明 应用服务器在物联网平台订阅了设备激活通知后(订阅的资源为device,事件为activate),当设备首次接入物联网平台并激活时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设备激活通知中的callbackUrl决定
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后(资源为device.status,事件为update),当物联网平台中的设备状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI
查询设备影子 接口说明 若设备处于离线或异常状态时,应用服务器无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。应用服务器可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 注意事项 当前仅使用
接口说明 应用服务器在物联网平台订阅了注册设备通知后(订阅的通知类型为deviceAdded),当应用服务器通过“注册设备”接口在平台注册设备时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
刷新token 接口说明 应用服务器通过鉴权接口获取到的accessToken是有效时间的,在accessToken快过期时,应用服务器通过调用此接口,获取新的accessToken。 URI 请求方法 POST URI /iocm/app/sec/v1.1.0/refreshToken
调用订阅接口时,回调地址如何获取? 以业务应用订阅设备数据变化通知为例,订阅和推送的流程如下: 应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知(携带回调地址和通知类型),物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。
批量创建设备命令 应用服务器若需要向多个设备下发相同的设备命令时,可调用此接口向批量设备下发命令。 此功能通过创建批量任务接口向设备下发批量任务实现,“taskType”参数设置为“DeviceCmd”时,为向批量设备下发命令。 父主题: 命令下发
创建订阅 接口说明 应用服务器可调用此接口订阅物联网平台资源的变化事件,当资源发生变化时(如设备激活,设备数据更新等),平台会向应用服务器发送通知消息。 URI 请求方法 POST URI /v5/iot/{project_id}/subscriptions 传输协议 HTTPS
查询单个订阅 接口说明 应用服务器可在物联网平台上创建多个订阅,以订阅不同类型的设备变更通知。应用服务器若需要查看某个订阅的配置信息,可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId}
查询设备影子历史数据 接口说明 应用服务器通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当应用服务器需要查看设备影子的历史配置记录时,可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/shadow/v1.5.0/deviceDesiredHistory