物联网平台

首页> 开发者中心>物联网平台>云应用开发指南>用户管理>查询用户设备列表

说明

查询用户绑定的设备列表

URL

/user/getUserDeviceList

请求方法

POST

请求参数

字段 类型 必选 说明
devices string 否 JSON string类型，指定查询的设备列表。若不传该字段，则默认返回全部设备列表。JSON结构为array of device，由多个device组成，device格式见下表。<br/>示例:[{“product_key”:”pk1”,”device_name”:”dn1”},{“product_key”:”pk2”,”device_name”:”dn2”}]
extra string 否 业务所需用户信息参数，数据格式 json ,如 extra= {“qid”:”123456”,”openid”:”fq415fqe”}。 json 的 key 和值都是字符串类型，openid是第三方账号标识。如果qid或openid不填写，公共参数中auth必填
公共请求参数 是 详见公共参数部分

device表

字段 类型 说明
product_key string 产品的唯一标识
device_name string 设备的唯一标识

响应数据

字段 类型 说明
request_id string 云平台为该请求生成的唯一标识符
errmsg string 调用失败时，返回的出错信息
errno number errno等于0表示成功，其他表示失败
data json数组对象 调用成功时，返回的数据。详情请见下表，该结果是数组对象，数组的每个成员是json对象，json的各个值见data表

data表：

字段 类型 说明
product_key string 产品唯⼀标识
device_name string 设备的唯一标识
device_title string 设备名称(用户自定义名称)
product_name string 设备所属产品的名称
product_logo string 设备所属产品的logo
category_name string 设备所属产品的分类
create_ts string 设备创建时间(时间戳)
modify_ts string 设备信息修改时间(时间戳)
bind_ts string 设备绑定时间（时间戳）
online_status string 在线:online;离线:offline
product_model string 设备型号
product_type int 产品类型
is_linked int 是否接入网关
linked_protocol string 接入协议
device_info json对象 其他设备信息，可扩展。数据格式json对象
recent_online_time string 设备最近一次在线时间戳,单位:秒(s), 若设备从未接入平台，则默认为”0”
gateway_info json对象 该设备所从属的网关信息。若不存在网关信息，则该字段不展示
enable_vcloud int 是否支持视频云: 0否；1是

响应示例

  1. {
  2.     "data": [
  3.         {
  4.             "bind_ts": 1566207900,
  5.             "category_name": "空调插座",
  6.             "create_ts": 1566202255,
  7.             "device_name": "11022435CC0B1C45",
  8.             "device_title": "WIFI空调插_C45",
  9.             "extra": "{"key": "value"}",
  10.             "modify_ts": 1566207900,
  11.             "online_status": "online",
  12.             "product_key": "ac6bec36d60f",
  13.             "product_logo": "https://p2.ssl.qhimg.com/t0163ba527ace1f5a33.png",
  14.             "product_model": "SN-KTC002",
  15.             "product_type":2,//枚举值: 1网关产品；2普通产品
  16.         "is_linked":1,//枚举值:1接入网关；0未接入。为0则不展示该字段
  17.         "linked_protocol":"wifi",//接入协议。为空则不展示该字段
  18.             "product_name": "16A智能空调插座"
  19.             "device_info": {
  20.         "ota_current_version": "设备固件当前版本",
  21.             "ota_version": "固件最新版本",
  22.             "ota_status": 1 // 固件升级状态
  23.             "roles":"用户角色"
  24.         },
  25.             "recent_online_time": "1581349039",
  26.         "gateway_info":{//若无网关信息，则该字段不存在
  27.             "product_key":"xxxxx",
  28.         "device_name":"xxxxx"
  29.             },
  30.         "enable_vcloud":0 //是否支持视频云: 0否；1是
  31.         },
  32.         {
  33.             "bind_ts": 1567062703,
  34.             "category_name": "路由器",
  35.             "create_ts": 1566819812,
  36.             "device_name": "api-gateway",
  37.             "device_title": "标准化设备",
  38.             "extra": "{"key": "value"}",
  39.             "modify_ts": 1567062703,
  40.             "online_status": "",
  41.             "product_key": "f3738bd07949",
  42.             "product_logo": "https://p4.ssl.qhimg.com/t01725bc9cf38e167de.jpg",
  43.             "product_model": "5_7_8",
  44.             "product_name": "标准化设备"
  45.             "device_info": {
  46.         "ota_current_version": "设备固件当前版本",
  47.             "ota_version": "固件最新版本",
  48.             "ota_status": 1 // 固件升级状态
  49.             "roles":"用户角色"
  50.         },
  51.             "recent_online_time": "1581349039",
  52.         "enable_vcloud":1 //是否支持视频云: 0否；1是
  53.         }
  54.     ],
  55.     "errmsg": "",
  56.     "errno": 0,
  57.     "request_id": "29e2f4b4-0ffd-4eaf-8185-f55b45cc6f87"
  58. }
即刻开始使用

只需完成注册与实名认证，即可体验我们的贴心服务

请您联系我们

邮箱

g-zyun@360.cn

电话

4000052360

小安提醒您

试用小安，请确保该账户已通过智汇云实名认证 前往认证中心>>

1对1免费 咨询智汇云专属顾问

为您量身定制产品解决方案

您的姓名 ：
手机号 ：
公司名称（选填) ：
相关产品 ：
留言内容 ：
提交
建议反馈
* 你对【智汇云】满意吗？
* 你对【智汇云】有哪些话要说？
+ 上传文件 支持格式 .png .jpg .jpeg .svg，不超过5MB。
取消 提交