Miku 直播

    • Miku 直播 > API 文档 > Pub转推API >任务详情

    任务详情

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

    描述

    查询指定 pub 转推任务的详细信息。

    接口信息

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

    请求参数

    Header 参数

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

    Path 参数

    参数名称 类型 必填 描述
    taskID string 是 任务 ID

    请求示例

    GET /tasks/<taskID> HTTP/1.1
Host: pub-manager.mikudns.com
Authorization: <QiniuToken>

    返回响应

    响应状态码

    响应示例

    {
  "taskID": "123",
  "uid": 0,
  "name": "task-001",
  "desc": "demo task",
  "runType": "seek",
  "sourceUrls": [
    {
      "url": "rtmp://example.com/live/stream",
      "isp": "",
      "seek": 0,
      "videoType": 0,
      "rtspType": 0
    }
  ],
  "forwardUrls": [
    {
      "url": "rtmp://push.example.com/app/stream",
      "isp": ""
    }
  ],
  "filter": {
    "ips": [],
    "area": "",
    "isp": ""
  },
  "status": "pending",
  "deliverStartTime": 1637100000000,
  "deliverStopTime": 1637100000000,
  "startTime": 1637100000000,
  "stopTime": 1637100000000,
  "createTime": 1637100000000,
  "loopTimes": 0,
  "retryTime": 60,
  "retry": 5,
  "preload": {
    "enable": true,
    "preloadTime": 1637000600000
  },
  "preloadStatus": "finished",
  "statusCallback": {
    "type": "JSON",
    "url": "https://callback.example.com",
    "vars": {
      "taskid": "$(taskID)",
      "status": "$(status)",
      "startTime": "$(startTime)",
      "stopTime": "$(stopTime)"
    },
    "timeout": 5,
    "retryTimes": 3,
    "retryInterval": 1
  }
}

    返回参数

    参数名称 类型 说明
    taskID string 任务 ID
    uid integer 用户 ID
    name string 任务名称
    desc string 任务描述
    runType string 任务类型，normal 普通转推，seek 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 预加载状态：running/failed/finished
    statusCallback object 状态回调配置
    以上内容是否对您有帮助？