#15.2 粉丝端聊天偶像列表【基础探测通过，待数据联调】

GET /tieup/api/v1/me/artist-chats

查询参数：

鉴权：需要 Authorization: Bearer <access_token>。

数据来自本地 tieup_subscription 订阅历史、tieup_artist_im_group 超级群配置和 tieup_im_message_stat 消息元数据，不调用融云远程查询群列表。列表按当前粉丝历史订阅过的艺人去重返回：刚订阅且尚无消息的艺人群会返回；订阅已到期的艺人群也会返回，但最后消息、历史消息和未读数只统计该粉丝订阅有效区间内的可见消息。

可见消息范围：

• 粉丝向艺人的定向消息：direction=1 且 fan_user_id=当前粉丝。
• 艺人向粉丝的定向消息：direction=2 且 fan_user_id=当前粉丝。
• 艺人超级群普通群发：direction=3。
• 不包含其他粉丝向同一艺人的定向消息。
• 最后消息允许 send_status=1 的正常消息或 send_status=3 的撤回消息，且 sent_at 必须落在当前粉丝对该艺人的任一 tieup_subscription.started_at ~ expires_at 区间内；撤回消息保留原消息位置并返回空正文占位，不回退到更早的普通消息。未读数仍只统计发送成功且未撤回的消息；续约中间断档期间的消息不返回、不计未读。
• 当前粉丝身份已通过“用户侧删除 IM 消息”接口删除的消息不再参与最后消息、会话排序和未读数计算；同一账号的偶像端身份及其他用户不受影响。

响应字段：

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "items": [
      {
        "artist_id": 20001,
        "artist_name": "示例艺人",
        "artist_avatar": "https://cdn.example.com/artist.png",
        "artist_online_status": 1,
        "rong_ultra_group_id": "tieup_artist_group_20001",
        "rong_channel_id": "",
        "is_current_fan": 1,
        "last_message": {
          "message_no": "MSG2026070610300012345678",
          "direction": 3,
          "conversationType": 10,
          "targetId": "tieup_artist_group_20001",
          "channelId": "",
          "messageId": 456,
          "messageDirection": 2,
          "senderUserId": "tieup_artist_20001",
          "sentStatus": 30,
          "receivedTime": 1783314600000,
          "sentTime": 1783314600000,
          "objectName": "RC:ImgMsg",
          "content": {},
          "messageUId": "XXXX-JJJJ-KKKK",
          "canIncludeExpansion": true,
          "expansionDic": {
            "senderRole": "artist",
            "artistId": "20001",
            "artistNickname": "示例艺人",
            "readCount": "328",
            "targetCount": "1000"
          },
          "directedUserIds": [],
          "disableUpdateLastMessage": false,
          "quoteInfo": {},
          "originMessage": {},
          "readReceiptInfo": {
            "isReceiptRequestMessage": false,
            "hasRespond": false,
            "userIdList": {}
          }
        },
        "unread_count": 0
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}

说明：聊天列表不会触发自动已读。last_message 按真实发送时间选择最后一条当前粉丝可见且未被当前身份删除的消息；最后消息已撤回时不会回退到上一条普通消息，而是保持原 objectName、messageUId、发送时间等历史字段并返回 content={}，客户端可展示“消息已撤回”。撤回消息不计入 unread_count，readReceiptInfo.isReceiptRequestMessage=false。last_message 为正常定向消息时，expansionDic.is_read 使用当前已落库的接收方实际阅读状态；正常群发消息不提供 is_read，改为通过一次 Redis Pipeline 批量读取实时人数，并动态返回字符串 readCount、targetCount。图片、语音、视频的正常 last_message.content 只返回远程链接和必要元数据，服务端不会把融云载荷中的 Base64 字段透传给 APP。