视频直播

产品文档

视频直播

describeLiveDomains

描述

查询域名列表

请求方式

GET

请求地址

https://live.jdcloud-api.com/v1/domains

请求参数

名称 类型 是否必需 默认值 描述
pageNum Integer False 1 页码
- 取值范围[1, 100000]
pageSize Integer False 10 分页大小
- 取值范围[10, 100]
publishDomain String False 推流域名
- 目前仅支持精确查询
- 为空时,查询用户所有直播域名

返回参数

名称 类型 描述
result Result
requestId String requestId

Result

名称 类型 描述
pageNumber Integer 当前页码
pageSize Integer 每页数量
totalCount Integer 查询总数
domainDetails DomainDetails[ ] 域名信息集合

DomainDetails

名称 类型 描述
publishDomains PublishDomain[ ] 推流域名集合
playDomains PlayDomain[ ] 播放域名集合

PlayDomain

名称 类型 描述
playDomain String 播放域名
playDomainCname String 播放域名Cname
domainStatus String 直播域名状态
online: 启用
offline: 停用
configuring: 配置中
configure_failed: 配置失败
checking: 正在审核
check_failed: 审核失败
playType String 播放域名类型
normal: 普通播放域名
restart: 回看域名
createTime String 域名创建时间
- UTC时间
格式: yyyy-MM-dd'T'HH:mm:ss'Z'
updateTime String 域名更新时间
- UTC时间
格式: yyyy-MM-dd'T'HH:mm:ss'Z'

PublishDomain

名称 类型 描述
publishDomain String 推流域名
publishDomainCname String 推流域名Cname
domainStatus String 直播域名状态
online: 启用
offline: 停用
configuring: 配置中
configure_failed: 配置失败
checking: 正在审核
check_failed: 审核失败
createTime String 域名创建时间
- UTC时间
格式: yyyy-MM-dd'T'HH:mm:ss'Z'
updateTime String 域名更新时间
- UTC时间
格式: yyyy-MM-dd'T'HH:mm:ss'Z'

返回码

返回码 描述
200 OK
400 Invalid parameter
401 Authentication failed
404 Not found
500 Internal server error
503 Service unavailable

请求示例

GET

https://live.jdcloud-api.com/v1/domains?publishDomain=push.yourdomain.com

返回示例

{
    "requestId": "bgvmivir54gddpgi764se9f4kfr7ge41", 
    "result": {
        "domainDetails": [
            {
                "playDomains": [
                    {
                        "createTime": "2017-11-27T06:51:25Z", 
                        "playDomain": "play.yourdomain.com", 
                        "playDomainCname": "play.yourdomain.com.live-play.xxx.jcloud-cdn.com", 
                        "playDomainStatus": "online", 
                        "playType": "normal", 
                        "updateTime": "2017-11-27T06:51:26Z"
                    }
                ], 
                "publishDomains": [
                    {
                        "createTime": "2017-11-27T06:51:25Z", 
                        "publishDomain": "push.yourdomain.com", 
                        "publishDomainCname": "push.yourdomain.com.live-publish.xxx.jcloud-cdn.com", 
                        "publishDomainStatus": "online", 
                        "updateTime": "2017-11-27T06:51:26Z"
                    }
                ]
            }
        ], 
        "pageNumber": 1, 
        "pageSize": 10, 
        "totalCount": 1
    }
}
更新时间:2019-07-16 16:48:46
文档反馈 docs feedback