查詢互動監聽事件列表

介面描述

由业务服务端调用，查询指定频道下当前仍挂在监听队列中的互动监听任务列表；
接口支持 HTTPS 协议。

介面URL

https://api.polyv.net/live/v5/chat/redirect/channel/interaction_event/list

請求方式

GET

介面約束

1、介面同時支援 HTTP、HTTPS，建議使用 HTTPS 確保介面安全。
2、**status** 由服務端根據當前時間與任務的 startTime、endTime 計算：waiting（未開始）、running（進行中）、ended（已結束）。
3、列表按頻道維度查詢；同一頻道可能存在歷史活動遺留的其他有效任務，聯調時建議結合 save/remove 或管理端清理。

請求參數描述

範例

請求範例：

GET https://api.polyv.net/live/v5/chat/redirect/channel/interaction_event/list?roomId=412738

回應體 JSON（成功）：

{
  "code": 200,
  "status": "success",
  "message": "获取成功",
  "data": {
    "list": [
      {
        "taskId": "task_sign_001",
        "activityId": "activity_20250521_001",
        "type": "signCount",
        "startTime": 1747785600000,
        "endTime": 1747785660000,
        "status": "running",
        "signCount": 1
      }
    ]
  }
}

無有效任務時 data.list 為空陣列 []。

回應參數描述

data.list 元素欄位

異常範例

參數校驗失敗：

{
  "code": 400,
  "status": "fail",
  "message": "缺少参数roomId"
}

頻道與帳號不匹配：

{
  "code": 400,
  "status": "fail",
  "message": "roomId非法"
}

未傳 x-auth-user-id：

{
  "code": 400,
  "status": "fail",
  "message": "accountId is required"
}

服務端異常：

{
  "code": 500,
  "status": "error",
  "message": "获取失败"
}

（具體 message 以實際錯誤資訊為準。）