视频监控

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

    创建空间

    最近更新时间:2020-05-06 15:28:45

    描述

    本接口用于创建新的业务空间。

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

    请求参数

    Body

    参数名称 必填 字段类型 说明
    name string 空间名称(格式"^[a-zA-Z0-9_-]{1,100}$")
    desc string 空间描述
    accessType string 接入类型(rtmp或者gb28181)
    rtmpUrlType accessType为"rtmp"时必填 integer accessType为“rtmp”时,推拉流地址计算方式,1:static, 2:dynamic
    domains rtmpUrlType为1时必填 string 数组 直播域名
    callBack string 回调地址,可用于获取空间内设备/流状态更新时的信息
    recordTemplateId string 录制模版ID,需要录制功能时输入对应的模板ID,录制模板ID可以模板管理中获取
    snapshotTemplateId string 截图模版ID,需要截图功能时输入对应的模板ID,截图模板ID可以模板管理中获取
    recordTemplateApplyAll boolean 空间模版是否应用到全局
    snapshotTemplateApplyAll boolean 截图模版是否应用到全局

    响应参数

    参数名称 类型 说明
    id string 空间ID
    name string 空间名称
    domains string数组 rtmp 静态接入的时候的域名
    domainDetails.domain string 推拉流域名
    domainDetails.type string 推拉流类型(publishRtmp/liveRtmp/liveHls/liveHdl)
    domainDetails.cname string 推拉流域名对应的cname
    accessType string 接入类型
    rtmpUrlType integer accessType为“rtmp”时,推拉流地址计算方式,1:static, 2:dynamic
    callBack string 回调地址
    recordTemplateId string 录制模版ID
    snapshotTemplateId string 截图模版ID
    recordTemplateApplyAll boolean 空间模版是否应用到全局
    snapshotTemplateApplyAll boolean 截图模版是否应用到全局
    disabled boolean 空间是否被禁用
    createdAt integer 空间创建时间
    updatedAt integer 空间更新时间

    示例

    请求示例

    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
        "name":"test001235",
        "accessType":"rtmp",
        "rtmpUrlType":1,
        "domains":["tests6.com"],
        "recordTemplateId":"2akrarrzr7rh5"
    }'
    

    响应示例

    {
      "id": "2akrars3nkw3s",
      "name": "test001235",
      "domains": [
        "tests6.com"
      ],
      "domainDetails": [
        {
          "domain": "qvs-publish.tests6.com",
          "type": "publishRtmp",
          "cname": "qvs-publish.tests6.com.qvspubv1.pilidns.com",
          "state": 0
        },
        {
          "domain": "qvs-live-rtmp.tests6.com",
          "type": "liveRtmp",
          "cname": "qvs-live-rtmp.tests6.com.qvsrtmpv1.pilidns.com",
          "state": 0
        },
        {
          "domain": "qvs-live-hls.tests6.com",
          "type": "liveHls",
          "cname": "qvs-live-hls.tests6.com.qvshlsv1.pilidns.com",
          "state": 0
        },
        {
          "domain": "qvs-live-hdl.tests6.com",
          "type": "liveHdl",
          "cname": "qvs-live-hdl.tests6.com.qvshdlv1.pilidns.com",
          "state": 0
        }
      ],
      "accessType": "rtmp",
      "rtmpUrlType": 1,
      "createdAt": 1586750356,
      "updatedAt": 1586750356,
      "recordTemplateId": "2akrarrzr7rh5",
      "recordTemplateApplyAll": false,
      "snapshotTemplateApplyAll": false,
      "disabled": false
    }
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close