15. 融云 API 15.9 偶像端群发任务列表【基础探测通过，待数据联调】

Table of Contents

15.9 偶像端群发任务列表【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/broadcast-tasks

查询参数：

参数 类型 必填 说明
page integer 否 页码，默认 1
page_size integer 否 每页数量，默认 20

鉴权：需要 Authorization: Bearer <access_token>，当前账号必须已开通偶像端。

返回当前偶像普通群发任务的目标人数、已读数、发送状态、融云消息 UID、失败原因等。 响应字段：

字段 类型 说明
items array 当前页数据列表
items[].task_no string 群发任务编号
items[].message_no string/null 关联平台消息编号
items[].rong_message_uid string/null 融云消息 UID
items[].rong_ultra_group_id string 融云超级群 ID
items[].rong_channel_id string 融云超级群频道 ID，默认频道为空
items[].message_type string 消息类型：text/image/voice/video
items[].content_digest string/null 消息内容摘要
items[].target_count integer 目标人数
items[].success_count integer 发送成功数，普通超级群消息成功后为 1
items[].failed_count integer 发送失败数
items[].read_count integer 已读数，来自群发已读聚合字段
items[].status integer 任务状态：1=待发送，2=发送中，3=已完成，4=部分失败，5=已取消
items[].queued_at string/null 入队时间
items[].started_at string/null 开始发送时间
items[].finished_at string/null 发送完成时间
items[].failed_reason string/null 失败原因
pagination.page integer 当前页码
pagination.page_size integer 每页数量
pagination.total integer 总数量
pagination.next_cursor string/null 游标分页预留字段，当前为空

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "items": [
      {
        "task_no": "BCT202607030001",
        "message_no": "MSG202607030003",
        "rong_message_uid": "XXXX-JJJJ-KKK-NNNN",
        "rong_ultra_group_id": "tieup_artist_group_20001",
        "rong_channel_id": "",
        "message_type": "text",
        "target_count": 320,
        "success_count": 1,
        "failed_count": 0,
        "read_count": 168,
        "status": 3,
        "queued_at": "2026-07-03 20:00:00",
        "started_at": "2026-07-03 20:00:01",
        "finished_at": "2026-07-03 20:00:01",
        "failed_reason": null
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}