API概览
调用以下接口前,请先参考认证鉴权完成认证鉴权操作。
产品管理
设备管理
API |
说明 |
---|---|
查询物联网平台中的设备信息列表。 |
|
在物联网平台注册一个设备,仅在注册后设备才可以接入物联网平台。 |
|
查询物联网平台中指定设备的详细信息。 |
|
修改物联网平台中指定设备的基本信息。 |
|
在物联网平台上删除指定设备。若设备下连接了非直连设备,则必须把设备下的非直连设备都删除后,才能删除该设备。 |
|
重置设备密钥,携带指定密钥时平台将设备密钥重置为指定的密钥,不携带密钥时平台将自动生成一个新的随机密钥返回。 |
|
冻结设备,设备冻结后不能再连接上线,可以通过解冻设备接口解除设备冻结。注意,当前仅支持冻结与平台直连的设备。 |
|
解冻设备,解除冻结后,设备可以连接上线。 |
|
应用服务器可调用此接口重置设备指纹。携带指定设备指纹时将之重置为指定值;不携带时将之置空。 |
|
应用服务器使用SQL语句调用该接口,灵活的搜索所需要的设备资源列表。 |
|
应用服务器调用该接口查询设备加入的设备组列表。 |
设备消息
API |
说明 |
---|---|
查询指定设备下的消息,平台为每个设备默认最多保存20条消息,超过20条后, 后续的消息会替换下发最早的消息。 |
|
向设备下发消息,应用服务器可调用此接口向指定设备下发消息,以实现对设备的控制。应用将消息下发给平台后,平台返回应用响应结果,平台再将消息发送给设备。 |
|
查询指定消息id的消息。 |
设备命令
设备属性
AMQP队列管理
API |
说明 |
---|---|
可调用此接口查询物联网平台中的AMQP队列信息列表。 |
|
可调用此接口在物联网平台创建AMQP队列。您可以通过调用数据流转规则管理接口,将数据推送到此AMQP队列。 |
|
可调用此接口查询物联网平台中指定队列的详细信息。 |
|
可调用此接口在物联网平台上删除指定AMQP队列。 |
接入凭证管理
API |
说明 |
---|---|
接入码是用于客户端使用AMQP等协议与平台建链的一个认证凭据,调用该接口将会生成一对新的接入码。 |
数据流转规则管理
API |
说明 |
---|---|
可调用此接口查询物联网平台中设置的规则条件列表。 |
|
可调用此接口在物联网平台创建一条规则触发条件。 |
|
可调用此接口查询物联网平台中指定规则条件的配置信息。 |
|
可调用此接口修改物联网平台中指定规则条件的配置参数。 |
|
可调用此接口删除物联网平台中的指定规则条件。 |
|
可调用此接口查询物联网平台中设置的规则动作列表。 |
|
可调用此接口在物联网平台创建一条规则动作。 |
|
可调用此接口查询物联网平台中指定规则动作的配置信息。 |
|
可调用此接口修改物联网平台中指定规则动作。 |
|
可调用此接口删除物联网平台中的指定规则动作。 |
流转数据
API |
说明 |
---|---|
应用服务器在物联网平台创建设备状态变更通知规则后,当物联网平台中的设备状态发生变更时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了设备属性上报通知规则后,当设备上报属性数据时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了消息状态变更通知规则后,当设备消息状态变更时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了批量任务状态变更通知规则后,当批量任务状态变更时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了设备消息上报通知规则后,当设备上报消息数据时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了设备添加事件规则后,当物联网平台中的设备添加时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了设备更新事件规则后,当物联网平台中的设备更新时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了设备删除通知事件规则后,当物联网平台中的设备删除时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了产品添加通知事件规则后,当物联网平台中的产品添加时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了产品更新通知事件规则后,当物联网平台中的产品更新时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了产品删除通知事件规则后,当物联网平台中的产品删除时,平台会向应用服务器推送通知消息。 |
|
应用服务器在物联网平台创建了命令状态变更通知后,当命令状态变更时,平台会向应用服务器推送通知消息。 |
设备联动规则
设备影子
API |
说明 |
---|---|
查询指定设备的设备影子信息,包括对设备的配置信息(desired区)和设备最新上报的数据信息(reported区)。当前仅使用LWM2M协议的设备支持设备影子功能,且仅支持修改LwM2M协议定义的属性信息,用户自定义的属性暂不支持修改。 |
|
配置设备影子的预期数据(desired区),当设备上线时把数据下发给设备。设备影子的属性和产品模型耦合在一起,配置的预期属性需在产品模型中定义且method具有可写属性“W”才可下发。当前仅使用LWM2M协议的设备支持设备影子功能,且仅支持修改LWM2M协议定义的属性信息,用户自定义的属性暂不支持修改。 |
设备组管理
资源空间管理
批量任务
API |
说明 |
---|---|
查询物联网平台中批量任务列表,每一个任务又包括具体的任务内容、任务状态、任务完成情况统计等。 |
|
创建批量处理任务,对多个设备进行批量操作。当前支持批量软固件升级、批量创建设备、批量修改设备、批量删除设备、批量冻结设备、批量解冻设备、批量创建命令、批量创建消息、批量配置设备影子和批量更新设备任务。 |
|
查询物联网平台中指定批量任务的信息,包括任务内容、任务状态、任务完成情况统计以及子任务列表等。 |
|
应用服务器可调用此接口删除物联网平台中已经完成(状态为成功,失败,部分成功,已停止)的批量任务。 |
|
应用服务器可调用此接口重试批量任务,目前只支持task_type为firmwareUpgrade,softwareUpgrade。如果task_id对应任务已经成功、停止、正在停止、等待中或初始化中,则不可以调用该接口。 |
|
应用服务器可调用此接口停止批量任务,目前只支持task_type为firmwareUpgrade,softwareUpgrade。如果task_id对应任务已经完成(成功、失败、部分成功,已经停止)或正在停止中,则不可以调用该接口。 |
|
查询批量任务文件列表。 |
|
上传批量任务文件,用于创建批量任务。当前支持批量创建设备任务、批量删除设备任务、批量冻结设备任务、批量解冻设备和批量更新设备任务的文件上传。 |
|
删除批量任务文件。 |
设备CA证书管理
API |
说明 |
---|---|
获取设备的CA证书列表。 |
|
上传设备的CA证书。 |
|
删除设备的CA证书。 |
|
验证设备的CA证书,目的是为了验证用户持有设备CA证书的私钥。 |
|
更新设备CA证书。 |
OTA升级包管理
API |
说明 |
---|---|
用户可调用此接口创建升级包关联OBS对象 。 |
|
用户可调用此接口查询关联OBS对象的升级包列表。 |
|
用户可调用此接口查询关联OBS对象的升级包详情。 |
|
用户可调用此接口删除关联OBS对象的升级包信息,不会删除OBS上对象。 |
广播消息
API |
说明 |
---|---|
应用服务器可调用此接口向订阅了指定Topic的所有在线设备发布广播消息。 |
设备隧道管理
设备代理
网桥管理
设备策略管理
预调配模板管理
API |
说明 |
---|---|
应用服务器可调用此接口创建创建预调配模板。 |
|
应用服务器可调用此接口查询所有创建预调配模板。 |
|
应用服务器可调用此接口删除预调配模板。 |
|
应用服务器可调用此接口查询创建预调配模板详情。 |
|
应用服务器可调用此接口更新指定id的预调配模板信息。 |
自定义鉴权
API |
说明 |
---|---|
应用服务器可调用此接口创建自定义鉴权。 |
|
应用服务器可调用此接口查询所有自定义鉴权。 |
|
应用服务器可调用此接口删除自定义鉴权。 |
|
应用服务器可调用此接口查询自定义鉴权详情。 |
|
应用服务器可调用此接口更新指定id的自定义鉴权。 |