检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
应用侧JAVA SDK API参考(联通用户专用) SDK使用说明(联通用户专用) API列表(联通用户专用) 应用安全接入 设备管理 数据采集 订阅管理 消息推送 命令下发 批量处理 设备组管理 设备升级
应用侧Python SDK API参考(联通用户专用) SDK使用说明 API列表 应用安全接入 设备管理 数据采集 订阅管理 消息推送 命令下发 批量处理 设备组管理 设备升级
用于关联设备所属的产品模型,与productId参数二选一。 model 可选 String(256) Body 设备的型号。与manufacturerId、manufacturerName、deviceType和model参数一起用于关联设备所属的产品模型,与productId参数二选一。
查询任务列表 接口说明 应用服务器可调用此接口查询已创建的升级任务列表信息,以了解当前已有的升级任务信息及各个任务的执行情况,可根据条件查询满足要求的升级任务信息。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/operations 传输协议 HTTPS
分页查询参数,查询结果分页显示时每页显示的记录数,默认1,最大值2000,建议根据设备上报数据的平均大小来设置,保证单次查询返回的包大小不超过16Mb,同时根据单次查询返回的包大小以及网络带宽设置合理的超时时间。 startTime 可选 String query 查询产生时间在startTime之后的历史数据
设备侧Agent Lite API参考(Android)(联通用户专用) 使用前必读 直连设备接入 非直连设备管理 上报设备数据 接收设备命令 发布数据
app_key 必选 String Header 已鉴权应用的appId Authorization 必选 String Header 请求的认证信息,值为“Bearer ******”,其中******为Auth鉴权接口返回的accessToken deviceId 必选 String
services[] 设备物模型的属性定义。 表2 services结构体 参数名称 类型 描述 service_id String 设备的服务ID,在设备关联的产品模型中定义。 properties ObjectNode[] 设备按照物模型上报的具体数据。 event_time String
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令,且当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 URI
应用服务器向物联网平台订阅设备信息,当设备信息发生变更时,物联网平台向应用服务器推送此消息,应用服务器根据通知类型对消息分派处理。需要配合订阅管理接口使用。 注册设备通知 绑定设备通知 设备信息变化通知 设备数据变化通知 设备数据批量变化通知 设备服务能力变化通知 设备服务能力增加通知 设备服务能力删除通知
query 设备所属的应用ID,当查询授权应用下的设备信息时才需要填写。 gatewayId 可选 String query 网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。
查询设备命令 接口说明 应用服务器向设备下发命令后,可调用此接口在物联网平台查询下发命令的状态及内容信息,以了解命令的执行情况,可查询指定时间段内本应用下的所有下发命令,或者指定设备的所有下发命令。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommands
查询批量任务的子任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后,可调用此接口查询该批量任务中子任务的详情信息,如任务的执行状态、任务内容等。 接口功能 支持第三方应用根据条件查询批量任务中子任务的详情信息,支持查询本应用创建的批量任务信息。 接口描述 1
网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。 appId 可选 String query 设备所属的应用ID,当查询授权应用下设备的服务能力时才需要填写。 deviceId
exceed. 应用调用接口过于频繁,超过流控值(默认值是100次/60s)。 处理建议:联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议:请检查接口请求中所携带的accessToken是否有误。
注册设备(验证码方式) 接口说明 在设备接入物联网平台前,应用服务器需要调用此接口在物联网平台注册设备,并设置设备的唯一标识(如IMEI)。在设备接入物联网平台时携带设备唯一标识,完成设备的接入认证。 此注册设备接口适用于使用LWM2M/CoAP协议接入的设备,或者集成了AgentLite
String(256) 设备的软件版本。 fwVersion String(256) 设备的固件版本。 hwVersion String(256) 设备的硬件版本。 imsi String NB-IoT终端的IMSI。 protocolType String(256) 设备使用的协议类型。 radiusIp
刷新设备密钥 接口说明 已在物联网平台注册的设备,若设备的唯一标识码发生变更(如更换设备等场景),应用服务器需要调用此接口在物联网平台更新设备的唯一标识,并重新绑定设备。 注意事项 仅当设备处于离线状态时,才能进行刷新设备密钥操作。 URI 请求方法 PUT URI /iocm/app/reg/v1
创建设备命令 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:
查询指定版本包 接口说明 在进行设备版本升级前,应用服务器可调用此接口在物联网平台查询某个版本升级包的信息,确保设备要升级的版本包已上传到平台,可根据版本包ID查询指定版本包信息,在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。 URI 请求方法 GET URI /iodm/northbound/v1