#15.7 偶像端全群消息列表【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/messages

查询参数：

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

说明：偶像端消息列表是当前偶像超级群的全量消息流，不按某个粉丝过滤；包含粉丝发给偶像、偶像定向回复粉丝、偶像普通群发三类消息。列表按 sent_at DESC, id DESC 倒序返回，优先返回最近发送成功或已撤回且本地已有发送时间的消息。粉丝端消息列表仍只返回当前粉丝与对应偶像相关的消息。本接口会先自动处理本页中偶像接收的未读粉丝定向消息，再批量读取最终定向状态和群发实时人数。

响应字段：

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "items": [
      {
        "message_no": "MSG202607030001",
        "direction": 1,
        "conversationType": 10,
        "targetId": "tieup_artist_group_20001",
        "channelId": "",
        "messageId": 123,
        "messageDirection": 2,
        "senderUserId": "tieup_fan_10001",
        "sentStatus": 30,
        "receivedTime": 1783058400000,
        "sentTime": 1783058400000,
        "objectName": "RC:SightMsg",
        "content": {
          "sightUrl": "https://cdn.example.com/im/video.mp4",
          "duration": 60,
          "size": "1048576",
          "name": "video.mp4"
        },
        "messageUId": "XXXX-JJJJ-KKK-LLLL",
        "canIncludeExpansion": true,
        "expansionDic": {
          "senderRole": "fan",
          "fanId": "10001",
          "artistId": "20001",
          "fanAvatar": "https://cdn.example.com/avatar.png",
          "fanNickname": "Tieup用户",
          "fanGender": "2",
          "companionStartAt": "2026-07-03 10:00:00",
          "companionDays": "26",
          "fanSubStatus": "auto_renew_active",
          "fanSubAutoRenew": "1",
          "fanSubExpiresAt": "2026-08-03 10:00:00",
          "fanSubExpiresText": "8月3日到期",
          "candySpent": "128.00",
          "lastArtistReplyAt": "2026-07-29 09:30:00",
          "lastArtistReplyText": "今日回复",
          "replyCount": "0",
          "is_read": "true"
        },
        "directedUserIds": [
          "tieup_artist_20001"
        ],
        "disableUpdateLastMessage": false,
        "quoteInfo": {},
        "originMessage": {},
        "readReceiptInfo": {
          "isReceiptRequestMessage": true,
          "hasRespond": true,
          "userIdList": {}
        }
      },
      {
        "message_no": "MSG202607030002",
        "direction": 3,
        "conversationType": 10,
        "targetId": "tieup_artist_group_20001",
        "channelId": "",
        "messageId": 124,
        "messageDirection": 1,
        "senderUserId": "tieup_artist_20001",
        "sentStatus": 30,
        "receivedTime": 1783058460000,
        "sentTime": 1783058460000,
        "objectName": "RC:TxtMsg",
        "content": {
          "content": "今晚八点直播见",
          "extra": ""
        },
        "messageUId": "XXXX-JJJJ-KKK-NNNN",
        "canIncludeExpansion": true,
        "expansionDic": {
          "senderRole": "artist",
          "artistId": "20001",
          "artistNickname": "示例艺人",
          "readCount": "328",
          "targetCount": "1000"
        },
        "directedUserIds": [],
        "disableUpdateLastMessage": false,
        "quoteInfo": {},
        "originMessage": {},
        "readReceiptInfo": {
          "isReceiptRequestMessage": true,
          "hasRespond": false,
          "userIdList": {}
        }
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 3,
      "next_cursor": null
    }
  }
}

说明：消息列表以本地 tieup_im_message_stat + tieup_im_message_content 为准，长期保存正文、扩展快照和撤回状态，不依赖融云超级群历史记录保留时间。items[] 的主体字段按根目录 融云响应字段参考.json 返回；仅额外保留 message_no、direction 供系统业务处理。偶像端 messageDirection 使用偶像视角：粉丝发给偶像为接收 2，偶像自己发出的定向和群发为发送 1。服务端会在偶像端拉取当前页历史消息时自动标记本页粉丝发给偶像的成功未撤回消息已读；偶像自己发送的定向和群发消息不触发已读写入。当前偶像身份已执行用户侧删除的消息不返回，也不计入 pagination.total；偶像消息收件箱会回退展示该粉丝上一条未删除消息，累计业务统计不因个人删除而减少。图片、语音、视频响应只裁剪返回副本中的 Base64，数据库历史快照和实际发送给融云的载荷保持不变。