视频监控

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

    获取设备列表

    最近更新时间: 2025-04-21 14:58:13

    描述

    本接口用于查询空间下的设备列表。

    • 接口请求域名：qvs.qiniuapi.com
    • 请求方式：GET
    • 接口路径：/v1/namespaces/{namespaceId}/devices?offset=<offset>&line=<line>&prefix=<prefix>&status=<status>&qtype=<qtype>&desc=<desc>&name=<name>
    • Get请求，通过非SDK方式调用的客户，http头部Content-Type,要么设置为application/x-www-form-urlencoded,要么置空, 要么不要携带; 公共http header说明

    请求参数

    路径参数

    参数名称 必填 字段类型 说明
    namespaceId 是 string 空间ID
    line 否 integer 一次返回多少条,最多1000,当超过1000条时，需要结合offset 循环读取。
    offset 否 integer 偏移量。当数据较多，需要循环读取时使用。例如有2001条数据，初始值offset = 0, 第N次请求时offset = (N -1) * line
    prefix 否 string 通过gbid精确查询。默认为""
    state 否 string 按设备状态查询，offline: 离线, online: 在线, notReg: 未注册
    qtype 否 integer 按设备类型查询，0:全部, 1:摄像头, 2:平台
    desc 否 string 按设备描述精确查询
    name 否 string 按设备名称精确查询

    响应参数

    参数名称 类型 说明
    items 设备数组 设备数组
    items.gbId string 设备国标Id
    items.name string 设备名称
    items.state string 状态（offline: 离线, online: 在线, notReg: 未注册）
    items.desc string 设备描述
    items.status boolean false: 未推流状态, true:推流状态
    items.createdAt integer 创建时间，Unix时间戳，秒
    items.updatedAt integer 更新时间，Unix时间戳，秒
    items.lastKeepaliveAt integer 最近心跳时间, Unix时间戳, 秒
    items.lastRegisterAt integer 最近注册时间, Unix时间戳, 秒
    items.deviceId string 设备id
    items.rtpAudio boolean 是否开启音频
    items.rtpAudioTranscode boolean 是否开启音频转码
    items.onDemandPull boolean 是否开启按需拉流

    示例

    请求示例

    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, "deviceId": "31011500991320000020" } ], "total": 2 }
    以上内容是否对您有帮助？