获取设备列表
HTTP请求地址: http(s)://api.yoyoiot.cn/{AppID}/device/list/?sign={sign}&ts={ts}
关于sign和ts的定义
或
MQTT发布主题: api/{AppID}/device/list
接收返回结果亦在同一主题
请求参数
GET|POST|JSON方式均有效
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| q | 否 | string | 搜索关键词,模糊匹配id和name
* 与tag参数同时传入时会被忽略 |
| product | 否 | string | 可指定产品,传产品ID,如1
多个产品,用间隔符(,或|)隔开,如1,2,3
如指定了多个产品,产品之间的关系为“或”,如上:会列出产品1以及产品2下的所有设备 |
| tag | 否 | string | 可指定标签,传标签ID,如1
多个标签,用间隔符(,或|)隔开,如1,2,3
如指定了多个标签,标签之间的关系为“或”,如上:会列出关联到标签1以及2的所有设备 |
| group | 否 | string | 可指定分组,传分组ID,如1
多个分组,用间隔符(,或|)隔开,如1,2,3
如指定了多个分组,分组之间的关系为“或”,如上:会列出分组1以及分组2下的所有设备 |
| page_index | 否 | int | 页码,默认1 |
| page_size | 否 | int | 默认10条,可为20、30、50 |
返回结果
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 返回状态值,200正确,其他错误请见接口首页“全局错误代码” |
| data | string | 设备列表:
id:设备ID
key:设备key
name: 设备名
remark: 设备备注信息
product: 产品:id、key、标题
group:分组:id、标题
state: 设备所有属性的当前状态值
network:设备联网情况(类型,名称,信号强度)
online:在线状态:状态值、上线IP地址、上线时间(如果不在线,后两个值为上次上线时的IP地址和时间)
create:初次创建时间
tags: 设备标签
create:生产日期
deliver:出厂日期 |
| msg | string | 返回状态信息 |
| page_index | int | 当前页码 |
| page_count | int | 总页数 |
| is_more | int | 是否还有更多数据 |
| total | int | 当前条件下的设备总数 |
返回示例