视频监控

  • 视频监控 > API Reference > 设备管理相关接口 >获取设备列表

    获取设备列表

    最近更新时间:2020-08-10 19:05:32

    描述

    本接口用于查询设备。

    • 接口请求域名:qvs.qiniuapi.com
    • 请求方式:GET
    • 接口路径:/v1/namespaces/{namespaceId}/devices?offset=<offset>&line=<line>&prefix=<prefix>&status=<status>&qtype=<qtype>

    请求参数

    路径参数

    参数名称 必填 字段类型 说明
    namespaceId string 空间ID
    offset integer 在全部流中的偏移量
    line integer 一次返回多少条
    prefix string 可以通过gbid前缀进行检索查询
    state string 按设备状态查询,offline: 离线, online: 在线, notReg: 未注册, locked: 锁定
    qtype integer 按设备类型查询,0:全部, 1:摄像头, 2:平台

    响应参数

    参数名称 类型 说明
    items 设备数组 设备数组
    items.gbId string 设备国标Id
    items.name string 设备名称
    items.state string 状态(offline: 离线, online: 在线, notReg: 未注册, locked: 锁定)
    items.desc string 设备描述
    items.status boolean false: 未推流状态, true:推流状态
    items.createdAt integer 创建时间,Unix时间戳,秒
    items.updatedAt integer 更新时间,Unix时间戳,秒
    items.lastKeepaliveAt integer 最近心跳时间, Unix时间戳, 秒
    items.lastRegisterAt integer 最近注册时间, Unix时间戳, 秒

    示例

    请求示例

    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    }'
    

    响应示例

    {
      "items": [
        {
          "name": "device1",
          "desc": "gb patch test",
          "nsId": "2akrarvzvyijd",
          "nsName": "gbt",
          "gbId": "31011500991320000028",
          "state": "notReg",
          "username": "username",
          "password": "password",
          "pullIfRegister": false,
          "createdAt": 1596166110,
          "updatedAt": 1596176486,
          "channels": 0,
          "lastRegisterAt": 0,
          "lastKeepaliveAt": 0
        },
        {
          "name": "beijing_test",
          "desc": "gbtest11",
          "nsId": "2akrarvzvyijd",
          "nsName": "gbt",
          "gbId": "31011500991320000020",
          "state": "offline",
          "username": "aaaaa",
          "password": "aaaaa",
          "pullIfRegister": true,
          "createdAt": 1595313745,
          "updatedAt": 1596081446,
          "channels": 0,
          "lastRegisterAt": 1596024977,
          "lastKeepaliveAt": 1596089383
        }
      ],
      "total": 2
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close