Miku 直播 > API 文档 > Pub转推API >任务列表

任务列表

最近更新时间: 2025-12-25 16:08:12

描述

列举 pub 转推任务列表。

接口信息

请求方法: GET
请求地址: pub-manager.mikudns.com
请求路径: /tasks

请求参数

Header 参数

参数名称	类型	必填	示例值	描述
Host	string	是	`pub-manager.mikudns.com`	服务域名
Authorization	string	是	`<QiniuToken>`	管理凭证 QiniuToken，生成规则

Query 参数

参数名称	类型	必填	描述
marker	string	否	翻页游标
limit	integer	否	返回数量上限，最大 1000
name	string	否	任务名称/描述模糊匹配

请求示例

GET /tasks?marker=123&limit=100&name=demo HTTP/1.1
Host: pub-manager.mikudns.com
Authorization: <QiniuToken>

返回响应

响应状态码

请查阅: 这里

响应示例

{
  "marker": "",
  "isEnd": true,
  "list": [
    {
      "taskID": "123",
      "uid": 123,
      "name": "task-001",
      "desc": "demo task",
      "sourceUrls": [
        {
          "url": "",
          "isp": "",
          "seek": 0,
          "videoType": 0,
          "rtspType": 0
        }
      ],
      "forwardUrls": [
        {
          "url": "",
          "isp": ""
        }
      ],
      "filter": {
        "area": "",
        "isp": "",
        "ip": [
          "",
          ""
        ]
      },
      "status": "pending",
      "deliverStartTime": 1630551226526,
      "deliverStopTime": 1630551226526,
      "startTime": 1630551226526,
      "stopTime": 1630551226526,
      "retry": 4,
      "createTime": 1630551226526,
      "loopTimes": 0,
      "retryTime": 60,
      "preload": {
        "enable": true,
        "preloadTime": 1637000600000
      },
      "preloadStatus": "finished",
      "statusCallback": {
        "type": "JSON",
        "url": "https://callback.example.com",
        "vars": {},
        "timeout": 5,
        "retryTimes": 3,
        "retryInterval": 1
      }
    }
  ]
}

返回参数

参数名称	类型	说明
marker	string	下一页游标
isEnd	boolean	是否已到末尾
list	array<object>	任务列表
├─ taskID	string	任务 ID
├─ uid	integer	用户 ID
├─ name	string	任务名称
├─ desc	string	任务描述
├─ runType	string	任务类型，`normal`/`seek`
├─ sourceUrls	array<object>	源地址列表
├─ forwardUrls	array<object>	转推地址列表
├─ filter	object	过滤条件
├─ status	string	任务状态，`pending`/`running`/`stopped`/`failed`/`finished`
├─ deliverStartTime	integer	定时开始时间，ms
├─ deliverStopTime	integer	定时结束时间，ms
├─ startTime	integer	任务开始时间，ms
├─ stopTime	integer	任务停止时间，ms
├─ createTime	integer	创建时间，ms
├─ loopTimes	integer	循环次数
├─ retryTime	integer	断流重试时间，秒
├─ retry	integer	剩余重试次数
├─ preload	object	预加载配置
├─ preloadStatus	string	预加载状态
└─ statusCallback	object	回调配置

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