检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询订阅 接口说明 应用服务器可调用此接口查询物联网平台中指定订阅的配置信息。 URI 请求方法 GET URI /v5/iot/{project_id}/subscriptions/{subscription_id} 传输协议 HTTPS 请求参数 名称 必选/可选 类型 位置
查询设备影子历史数据 接口说明 应用服务器通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当应用服务器需要查看设备影子的历史配置记录时,可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/shadow/v1.5.0/deviceDesiredHistory
注册设备(验证码方式) 典型场景 在设备接入物联网平台前,第三方应用需要调用此接口在物联网平台注册设备,并把设备的唯一标识码(如IMEI)设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识,完成设备的接入认证。 接口功能 支持第三方应用在物联网平台注册设备,完成注册后设备方可接入物联网平台。
设备服务调用 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令,设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设
修改订阅 接口说明 应用服务器可调用此接口修改物联网平台中的指定订阅配置,当前仅支持修改订阅回调地址(callbackurl)。 URI 请求方法 PUT URI /v5/iot/{project_id}/subscriptions/{subscription_id} 传输协议 HTTPS
刷新设备密钥 接口说明 已在物联网平台注册的设备,若设备的唯一标识码发生变更(如更换设备等场景),应用服务器需要调用此接口在物联网平台更新设备的唯一标识,并重新绑定设备。 注意事项 仅当设备处于离线状态时,才能进行刷新设备密钥操作。 URI 请求方法 PUT URI /iocm/app/reg/v1
刷新设备密钥 典型场景 已在物联网平台注册的设备,若设备的唯一标识码发生变更(如更换设备等场景),第三方应用需要调用此接口在物联网平台更新设备的唯一标识,并重新绑定设备。 仅当设备处于离线状态时,才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的no
返回结果 请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,物联网平台返回的状态码如下所示。 对于鉴权接口,如果调用后返回状态码为“200”,则表示请求成功。 状态码 编码 状态码说明 200
查询设备历史数据 接口说明 在日常运行中,物联网平台会收到并保存设备上报业务数据,应用服务器若需要查看某个设备上报到平台的历史数据,可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/data/v1.2.0/deviceDataHistory 传输协议 HTTPS
设备快速接入(联通用户专用) 非联通用户请查看设备接入服务。 本文档以MQTT.fx为例,介绍以MQTT原生协议接入物联网平台。MQTT.fx是目前主流的MQTT客户端,可以快速验证是否可以与物联网平台服务交互发布或订阅消息。 前提条件 已经注册华为云官方帐号,可点击注册页面完成注册。
查询指定批量任务信息 接口说明 应用服务器通过“创建批量任务”接口创建了设备的批量操作任务后,可调用此接口查询该批量任务的信息,包括任务的当前状态、子任务(指批量任务中一个设备执行的任务)完成情况等。 URI 请求方法 GET URI /iocm/app/batchtask/v1
设备响应命令 接口说明 设备对物联网平台控制命令的应答。 应用服务器要需要调用“订阅平台业务数据”API订阅“commandRsp”类型的通知后,才能接收到设备对控制命令的应答。 Topic Topic /huawei/v1/devices/{deviceId}/data/{codecMode}
查询设备命令撤销任务 接口说明 应用服务器创建了设备命令撤销任务后,可调用此接口查询设备命令撤销任务的详细信息和执行状态,以了解撤销任务的执行情况,可指定条件查询单个或多个撤销任务。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommandCancelTasks
注册设备(验证码方式) 接口说明 在设备接入物联网平台前,应用服务器需要调用此接口在物联网平台注册设备,并设置设备的唯一标识(如IMEI)。在设备接入物联网平台时携带设备唯一标识,完成设备的接入认证。 此注册设备接口适用于使用LWM2M/CoAP协议接入的设备,或者集成了AgentLite
修改设备组 接口说明 若因业务变更需要修改设备组的信息,如设备组名称、设备组的设备数量限制等,应用服务器可调用此接口修改指定设备组的信息。 URI 请求方法 PUT URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议
查询指定设备组 接口说明 应用服务器若需要查看某个设备组的信息,以了解该设备组的使用情况,可调用此接口查询指定设备组的信息。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议 HTTPS 请求参数
固件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了固件升级状态变更通知后(订阅的通知类型为fwUpgradeStateChangeNotify),当设备进行固件升级,升级任务的状态发生变化时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息。
应用快速接入(联通用户专用) 非联通用户请查看设备接入服务。 为了降低应用侧的开发难度、提升应用侧开发效率,物联网平台向应用侧开放了丰富的Restful API。本文档以Postman为例,模拟应用服务器以HTTPS协议为例接入物联网平台。 前提条件 已经注册华为云官方帐号,可点击注册页面完成注册。
删除设备 接口说明 已在物联网平台注册的设备,若不再需要接入平台时,应用服务器可调用此接口在物联网平台删除设备,使设备无法再接入平台。后续设备若需要再次接入平台,则需重新注册设备。 URI 请求方法 DELETE URI /iocm/app/dm/v1.4.0/devices/{deviceId}
批量删除订阅 接口说明 应用服务器若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1