Miku 直播 > API 文档 > 域名管理API >绑定上行域名

绑定上行域名

最近更新时间: 2025-11-20 22:47:16

描述

为指定直播空间绑定上行域名（推流域名）

接口信息

请求方法: POST
请求地址: <bucket>.mls.cn-east-1.qiniumiku.com
请求路径: /

请求参数

Query 参数

参数名称	类型	必填	示例值	描述
pushDomain	string	是	pushDomain	域名配置

Header 参数

参数名称	类型	必填	示例值	描述
Host	string	是	`<bucket>`.mls.cn-east-1.qiniumiku.com	请求的服务域名
Authorization	string	是	`<QiniuToken>`	管理凭证 QiniuToken，生成规则

Body 参数 (application/json)

示例：

{
    "domain":"www.example.com",
    "type":"pushRtmp"
}

参数

参数名称	类型	是否必需	说明
domain	string	必需	域名
type	string	必需	域名类型（pushRtmp：rtmp 推流域名；whip：whip 推流域名；pushSrt：srt 推流域名）

请求示例

POST /?pushDomain HTTP/1.1
Host: test.mls.cn-east-1.qiniumiku.com
Authorization: <QiniuToken>
Content-Type: application/json

{
    "domain":"www.example.com",
    "type":"pushRtmp"
}

返回响应

响应状态码

请查阅: 这里

响应示例

{
    "domain": "www.example.com",
    "cname": "www.example.com.publish.mikudns.com",
    "creationDate": "2019-01-01T00:00:00.000+08:00",
    "lastModified": "2019-01-01T00:00:00.000+08:00",
    "connectId": "QXV0aG9yaXphdGlvbg",
    "type": "pushRtmp"
}

响应参数

参数名称	类型	说明
domain	string	域名
cname	string	CNAME 域名别名
creationDate	string	创建时间，遵循 ISO 8601 格式
lastModified	string	修改时间，遵循 ISO 8601 格式
connectId	string	连接 id
type	string	域名类型（pushRtmp：rtmp 推流域名；whip：whip 推流域名；pushSrt：srt 推流域名）

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