#15.13 用户侧删除 IM 消息【新增，待联调】

DELETE /tieup/api/v1/im/messages
Content-Type: application/json
Authorization: Bearer <access_token>

请求体：

{
  "message_nos": [
    "MSG202607030001",
    "MSG202607030002"
  ]
}

请求字段：

鉴权：需要 Authorization: Bearer <access_token>。删除身份由 Token 的 current_identity 决定，客户端不能在请求体指定。粉丝端可删除本人订阅可见时间窗内的定向消息或群发消息；偶像端可删除自己超级群内的消息。自己发送、接收及已撤回占位消息均可删除。

响应字段：

完整响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "requested_count": 2,
    "deleted_count": 2,
    "already_deleted_count": 0,
    "ignored_count": 0,
    "read_count": 1,
    "queued_count": 0
  }
}

说明：

• 该接口是“仅自己这边删除”，服务端只写 tieup_im_message_delete 可见性记录，不删除 tieup_im_message_stat、tieup_im_message_content，不调用融云撤回，也不影响对方、其他粉丝或同账号另一身份。
• 删除未读接收消息时，服务端先复用现有已读事务或群发 Redis + 队列链路；新未读消息未完成已读时不写删除记录并返回失败，客户端可以安全重试。
• 重复请求和并发请求由 (viewer_user_id, viewer_identity, message_no) 唯一键保证幂等；合法请求即使全部为已删除或忽略项也返回 code=200，客户端根据计数字段处理。
• 删除后，当前身份的历史消息、分页总数、最后消息、会话排序和未读数均排除这些消息。偶像删除被引用的粉丝消息后，不能再以该消息发起新的引用回复；其他已存在消息中的 quoteInfo 引用定位信息继续保留，但当前身份不再通过 originMessage 获取已删除原消息正文。
• 接口成功后，客户端必须同步从当前设备融云 SDK 本地数据库或 UI 数据源移除对应消息；后端无法自动清理设备已有缓存。其他设备重新请求本地历史接口时会按服务端删除记录保持不可见。
• 当前不提供恢复接口，用户侧删除记录长期生效；撤回接口仍用于“发送者撤回且双方显示撤回占位”，两者语义不得混用。