查询混流任务信息

更新时间：2025-04-15 17:17

1 描述

根据指定混流任务的 taskid 查询相关信息。

2 接口原型

请求方法：GET
请求地址：https://rtc-api.zego.im/?Action=GetMixTaskInfo
传输协议：HTTPS
调用频率限制：100 次/秒

3 请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考调用方式中的 “2.1 公共请求参数”。

参数	类型	是否必选	描述
TaskId	String	是	任务 ID，混流任务的唯一标识。

4 请求示例

https://rtc-api.zego.im/?Action=GetMixTaskInfo
&TaskId=task_test_123
&<公共请求参数>

5 响应参数

参数	类型	描述
Code	Number	返回码。
Message	String	操作结果描述。
RequestId	String	请求 ID。
Data	Object	响应数据。
TaskInfo	Object	混流任务信息。
TaskId	String	混流任务 ID。
MixDuration	Int	混流任务持续时长，单位秒。

6 响应示例

{
    "Code": 0,
    "Message": "success",
    "RequestId": "1864314306034131629",
    "Data": {
        "TaskInfo": {
            "TaskId": "task_test_123",
            "MixDuration": 13
        }
    }
}

7 返回码

以下仅列出了常见的接口业务逻辑相关的返回码，完整返回码请参考全局返回码。

返回码	说明	处理建议
0	请求成功。	-
110200001	失败。	建议重试。一般是网络错误异常导致。
110200004	解析输入参数失败。	请检查混流参数是否正确。
110200194	混流请求过载。	请求过于频繁，请稍后再试。
110209001	混流任务不存在。	请核查该混流任务是否正在进行。如果混流任务实际正在进行，请联系 ZEGO 技术支持。