视频监控

  • 视频监控 > API Reference > 设备管理相关接口 >创建设备

    创建设备

    最近更新时间:2020-09-11 11:02:05

    描述

    本接口用于创建设备。

    • 接口请求域名:qvs.qiniuapi.com
    • 请求方式:POST
    • 接口路径:/v1/namespaces/{namespaceId}/devices

    请求参数

    路径参数

    参数名称 必填 字段类型 说明
    namespaceId string 空间ID

    Body

    参数名称 必填 字段类型 说明
    name string 设备名称(可包含 字母、数字、中划线、下划线;1 ~ 100 个字符长)
    gbId string 设备国标ID 要求全局唯一, 该字段为空时,会自动创建gbid
    username string 用户名, 4~40位,可包含大写字母、小写字母、数字、中划线。当该字段为空时,默认值就是设备国标ID
    password string 密码, 4~40位,可包含大写字母、小写字母、数字、中划线
    pullIfRegister boolean 注册成功后启动拉流, 默认关闭
    desc string 关于设备的描述信息

    响应参数

    参数名称 类型 说明
    name string 设备名称
    desc string 设备描述
    nsId string 所属的空间ID
    nsName string 所属的空间名称
    gbId string 设备国标ID
    state string 状态(offline: 离线, online: 在线, notReg: 未注册, locked: 锁定)
    username string 用户名
    password string 密码
    pullIfRegister boolean 注册成功后启动拉流, 默认关闭
    channels integer 设备通道数
    vendor string 厂商
    createdAt integer 创建时间,Unix时间戳,秒
    updatedAt integer 更新时间,Unix时间戳,秒
    lastRegisterAt integer 上一次注册时间,Unix时间戳,秒
    lastKeepaliveAt integer 上一次心跳时间,Unix时间戳,秒

    示例

    请求示例

    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
        "name": "device1",
        "desc": "test gb28181",
        "username": "username",
        "password": "password"
    }'
    

    响应示例

    {
      "name": "device1",
      "desc": "test gb28181",
      "nsId": "2akrarvzvyijd",
      "nsName": "gbt",
      "gbId": "31011500991320000028",
      "state": "notReg",
      "username": "username",
      "password": "password",
      "pullIfRegister": false,
      "createdAt": 1596166110,
      "updatedAt": 1596166110,
      "channels": 0,
      "lastRegisterAt": 0,
      "lastKeepaliveAt": 0
    }
    

    注意
    每个设备会创建一路流, 普通设备以GBId作为stramId,平台设备以平台国标ID_通道国标ID作为streamId

    以上内容是否对您有帮助?
  • Qvm free helper
    Close