直播云 > API 文档 > 直播空间管理API >查询直播空间信息

查询直播空间信息

最近更新时间: 2021-11-01 20:13:28

接口描述

查询目标直播空间信息，包括直播空间基本信息、绑定的域名列表、存储空间信息和直播空间配置信息

请求参数

GET /v2/hubs/<hub>
Host: pili.qiniuapi.com 
Authorization: <QiniuToken>
Content-Type: application/x-www-form-urlencoded

参数	类型	必填	描述
Hub	string	是	直播空间名

返回数据

参数	类型	描述
Name	string	直播空间名
CreatedAt	int64	创建时间
UpdatedAt	int64	更新时间
Domains	[]object	直播空间下的域名列表
├─ Type	string	域名类型，包括： publishRtmp：推流域名 liveRtmp：RTMP播放域名 liveHls：HLS播放域名 liveHdl：FLV播放域名
├─ Domain	string	域名
├─ Cname	string	CNAME
DefaultDomains	[]object	直播空间默认域名
├─ Type	string	域名类型
├─ Domain	string	域名
StorageBucket	string	与直播空间绑定的存储空间
LiveDataExpireDays	int64	存储过期时间，单位：天
PublishSecurity	string	推流鉴权方式
Nrop	object	鉴黄配置信息
├─ Enable	bool	是否开启直播空间级别鉴黄功能
├─ Interval	int	截帧间隔，每个流隔多久进行截帧并鉴黄，单位：秒
├─ NotifyURL	string	回调 URL
├─NotifyRate	float64	通知阈值，鉴黄结果阈值表示AI模型判断当前直播画面有多大的概率涉黄，当鉴黄结果阈值大于或等于通知阈值时，将发送回调信息到回调URL
PassiveCodecProfiles	[]string	被动转码配置，形式如：720p
Converts	[]string	主动转码配置，形式如：720p
HlsPlus	bool	是否开启 hls 低延迟
VodDomain	string	点播域名
AccessLog	object	直播日志保存信息
├─SaveBucket	string	存储空间
├─ExpireDays	int	过期天数
SnapshotInterval	int	直播封面的截图间隔，单位：秒

示例

请求体:

GET /v2/hubs/test HTTP/1.1
Host: pili.qiniuapi.com 
Authorization: <QiniuToken>
Content-Type: application/x-www-form-urlencoded

返回体:

200 OK

{
    "hubName": "test",
    "createdAt": 1484795401,
    "updatedAt": 1634543051,
    "domains": [
        {
            "type": "publishRtmp",
            "domain": "pili-publish.testhub.cloudvdn.com",
            "cname": "pili-publish.testhub.cloudvdn.com.publish.z0.pili.pilidns.com"
        },
        {
            "type": "liveRtmp",
            "domain": "pili-live-rtmp.testhub.cloudvdn.com",
            "cname": "pili-live-rtmp.testhub.cloudvdn.com.live-rtmp.z0.pili.pilidns.com"
        },
        {
            "type": "liveHls",
            "domain": "pili-live-hls.testhub.cloudvdn.com",
            "cname": "pili-live-hls.testhub.cloudvdn.com.live-hls.z0.pili.pilidns.com"
        },
        {
            "type": "publishRtmp",
            "domain": "pili-publish.test3.qbox.net",
            "cname": "pili-publish.test3.qbox.net.publish.z0.pili.pilidns.com"
        },
        {
            "type": "liveRtmp",
            "domain": "pili-live-hw-rtmp.testhub.cloudvdn.com",
            "cname": "pili-live-hw-rtmp.testhub.cloudvdn.com.live-rtmp.z0.pili.pilidns.com"
        },
        {
            "type": "liveRtmp",
            "domain": "pili-live-b-rtmp.testhub.cloudvdn.com",
            "cname": "pili-live-b-rtmp.testhub.cloudvdn.com.live-rtmp.z0.pili.pilidns.com"
        }
    ],
    "defaultDomains": [
        {
            "type": "liveRtmp",
            "domain": "pili-live-rtmp.testhub.cloudvdn.com"
        },
        {
            "type": "publishRtmp",
            "domain": "pili-publish.testhub.cloudvdn.com"
        },
        {
            "type": "liveHls",
            "domain": "pili-live-hls.testhub.cloudvdn.com"
        }
    ],
    "storageBucket": "test2z0",
    "liveDataExpireDays": 180,
    "publishSecurity": "none",
    "nrop": {
        "enable": false,
        "interval": 5,
        "notifyURL": "http://pili.com",
        "notifyRate": 0.8
    },
    "passiveCodecProfiles": [
        "480p",
        "720p",
        "180p"
    ],
    "converts": [],
    "hlsPlus": false,
    "vodDomain": "pili-vod.testhub.cloudvdn.com",
    "accesslog": {
        "saveBucket": "",
        "expireDays": 0
    },
    "snapshotInterval": 10
}

SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往下载

以上内容是否对您有帮助？