IoT视频云

  • IoT视频云 > API Reference > 设备管理 >查询设备信息

    查询设备信息

    最近更新时间:2019-10-30 17:15:46

    描述

    该接口用于查询指定设备的详细信息。

    请求

    请求语法
    方法一:

    GET /v1/apps/<appid>/devices/<encodeDeviceName> HTTP/1.1
    Host: linking.qiniuapi.com
    Content-Type: application/x-www-form-urlencoded
    Authorization: <QiniuToken>
    

    参数说明

    参数名称 必填 字段类型 说明
    appid string 设备所属应用的appid,设备名称只能由 4-200 位英文字母和数字组成
    encodeDeviceName string 设备名称进行URL安全的Base64编码后得到的字符串

    方法二:适用于客户端通过dtoken方式访问。

    GET /v1/device/resource/status?dtoken=<deviceAccessToken> HTTP/1.1
    Host: linking.qiniuapi.com
    

    参数说明

    参数名称 必填 字段类型 说明
    dtoken string dtoken是用于访问Linking服务时的凭证。生成方式请参照设备访问凭证

    请求头
    该请求操作的实现使用了所有操作的公共请求头。有关详细信息,请查阅公共请求头

    请求元素
    该请求操作的请求体为空。

    响应

    响应头
    该请求操作的实现使用了所有操作的公共响应头。有关详细信息,请查阅公共响应头
    响应元素

    200 {
      "device": "<deviceName>",
      "loginAt": "<loginTimestamp>",
      "remoteIp": "<remoteIp>",
      "state": "<state>",
      "segmentExpireDays": "<segmentExpireDays>", 
      "activedAt": "<activedTimestamp>", 
      "createdAt": "<createdTimestamp>", 
      "updatedAt": "<updatedTimestamp>",
      "type": "<Type> ",
      "maxChannel": "<maxChannel>",
      "channels":[{"channelid":"<Channelid>", "comment":"<comment>"}],
      "meta": {} 
    }
    
    参数名称 说明
    device 设备名称
    loginAt 设备是否在线,设备在线才会出现此字段
    remoteIp 登录IP,设备在线才会出现此字段
    state 设备禁用/启用,1表示被禁用, 0表示已启用
    segmentExpireDays 设备录制文件的生命周期天数
    >0:自定义设置文件保存天数
    0:不录制
    -1:永久
    -2:继承app配置
    activedAt 设备首次激活时间
    createdAt 设备创建时间
    updatedAt 设备更新时间
    type 设备类型,0:设备, 1:网关
    maxChannel 网关设备最大channel数,当type为网关时才显示此项
    channels 频道信息,当type为网关时才显示此项,channelid:频道id,comment:频道备注信息
    meta 用户自定义的设备属性信息,(为空不返回)

    示例

    请求示例

    GET /v1/apps/test/devices/dGVzdGRldmljZTE= HTTP/1.1
    Host: linking.qiniuapi.com
    Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=
    Content-Type: application/x-www-form-urlencoded
    

    响应示例

    HTTP/1.1 200 OK
    Access-Control-Allow-Origi: *
    Connection: keep-alive
    Content-Length: 184
    Content-Type: application/json
    Date: Wed, 26 Sep 2018 11:42:10 GMT
    Server: nginx/1.8.0
    Vary: Accept-Encoding
    X-Reqid: 6SAAABDWHM1o8FcV
    X-Whom: cs1
    
    200 {
      "device": "testdevice1",
      "loginAt": 1537853919,
      "state": 0,
      "segmentExpireDays": 7,
      "activedAt": 1537853919,
      "createdAt": 1537853912,
      "updatedAt": 1537853919
    }
    
    400  {
        "error":  "bad request"
    }
    
    以上内容是否对您有帮助?
  • Icon helper
    Icon free helper
    Close