Skip to content

im 接口清单(IM) ​

30 个控制器、126 个接口、34 个唯一权限点。

ImChannelManagerController · 管理后台 - IM 频道 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/channel/ImChannelManagerController.java

方法路径权限点摘要行
POST/im/manager/channel/createim:manager:channel:create新增频道34
PUT/im/manager/channel/updateim:manager:channel:update修改频道41
DELETE/im/manager/channel/deleteim:manager:channel:delete删除频道49
GET/im/manager/channel/pageim:manager:channel:query获得频道分页58
GET/im/manager/channel/getim:manager:channel:query获得频道详情66
GET/im/manager/channel/simple-list—获得启用的频道精简列表;前端表单选择频道时调用75

ImChannelMaterialController · 用户 APP - IM 频道素材 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/channel/ImChannelMaterialController.java

方法路径权限点摘要行
GET/im/channel/material/get—获取素材详情;用于客户端点击图文卡片渲染详情页30

ImChannelMaterialManagerController · 管理后台 - IM 频道素材 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/channel/ImChannelMaterialManagerController.java

方法路径权限点摘要行
POST/im/manager/channel-material/createim:manager:channel-material:create新增素材42
PUT/im/manager/channel-material/updateim:manager:channel-material:update修改素材49
DELETE/im/manager/channel-material/deleteim:manager:channel-material:delete删除素材57
GET/im/manager/channel-material/pageim:manager:channel-material:query获得素材分页;含频道名回填66
GET/im/manager/channel-material/getim:manager:channel-material:query获得素材详情(含富文本正文)82
GET/im/manager/channel-material/simple-list—获得指定频道下的素材精简列表;用于推送弹窗的素材下拉91

ImChannelMessageController · 用户 APP - IM 频道消息 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/message/ImChannelMessageController.java

方法路径权限点摘要行
GET/im/channel/message/pull—拉取频道消息(离线增量);按 minId 游标分页41
PUT/im/channel/message/read—标记频道消息已读65

ImChannelMessageManagerController · 管理后台 - IM 频道消息 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/message/ImChannelMessageManagerController.java

方法路径权限点摘要行
POST/im/manager/channel-message/sendim:manager:channel-message:send立即推送频道消息44
DELETE/im/manager/channel-message/deleteim:manager:channel-message:delete删除频道消息51
GET/im/manager/channel-message/pageim:manager:channel-message:query获得频道消息分页;回填频道名 / 素材标题60

ImConversationReadController · 管理后台 - IM 会话读位置 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/conversation/ImConversationReadController.java

方法路径权限点摘要行
GET/im/conversation-read/pull—增量拉取当前用户的会话读位置(重连 / 离线补偿)35

ImFacePackController · 管理后台 - IM 表情包 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/face/ImFacePackController.java

方法路径权限点摘要行
GET/im/face-pack/list—获得启用的表情包列表(含表情)37

ImFacePackItemManagerController · 管理后台 - IM 表情包项 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/face/ImFacePackItemManagerController.java

方法路径权限点摘要行
POST/im/manager/face-pack-item/createim:manager:face-pack-item:create新增表情34
PUT/im/manager/face-pack-item/updateim:manager:face-pack-item:update修改表情41
DELETE/im/manager/face-pack-item/deleteim:manager:face-pack-item:delete删除表情49
DELETE/im/manager/face-pack-item/delete-listim:manager:face-pack-item:delete批量删除表情58
GET/im/manager/face-pack-item/pageim:manager:face-pack-item:query获得表情分页68
GET/im/manager/face-pack-item/getim:manager:face-pack-item:query获得表情详情76

ImFacePackManagerController · 管理后台 - IM 表情包 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/face/ImFacePackManagerController.java

方法路径权限点摘要行
POST/im/manager/face-pack/createim:manager:face-pack:create新增表情包34
PUT/im/manager/face-pack/updateim:manager:face-pack:update修改表情包41
DELETE/im/manager/face-pack/deleteim:manager:face-pack:delete删除表情包49
DELETE/im/manager/face-pack/delete-listim:manager:face-pack:delete批量删除表情包58
GET/im/manager/face-pack/pageim:manager:face-pack:query获得表情包分页68
GET/im/manager/face-pack/getim:manager:face-pack:query获得表情包详情76

ImFaceUserItemController · 管理后台 - IM 个人表情 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/face/ImFaceUserItemController.java

方法路径权限点摘要行
GET/im/face-user-item/list—获得我的个人表情列表31
POST/im/face-user-item/create—添加个人表情38
DELETE/im/face-user-item/delete—删除个人表情44

ImFaceUserItemManagerController · 管理后台 - IM 用户表情 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/face/ImFaceUserItemManagerController.java

方法路径权限点摘要行
GET/im/manager/face-user-item/pageim:manager:face-user-item:query获得用户表情分页38
DELETE/im/manager/face-user-item/deleteim:manager:face-user-item:delete删除用户表情58

ImFriendController · 管理后台 - IM 好友 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/friend/ImFriendController.java

方法路径权限点摘要行
GET/im/friend/list—获得当前登录用户的好友列表48
GET/im/friend/pull—增量拉取当前用户的好友关系(重连 / 离线补偿)55
GET/im/friend/get—获得好友详情70
DELETE/im/friend/delete—删除好友(单向软删除)78
PUT/im/friend/update—更新好友单边属性(备注 / 免打扰 / 联系人置顶)91
PUT/im/friend/block—拉黑好友(必须先是好友;单边屏蔽对方私聊消息)98
PUT/im/friend/unblock—移出黑名单107

ImFriendManagerController · 管理后台 - IM 好友管理 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/friend/ImFriendManagerController.java

方法路径权限点摘要行
GET/im/manager/friend/pageim:manager:friend:query获得好友关系分页42

ImFriendRequestController · 管理后台 - IM 好友申请 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/friend/ImFriendRequestController.java

方法路径权限点摘要行
POST/im/friend-request/apply—发起好友申请55
PUT/im/friend-request/agree—同意好友申请62
PUT/im/friend-request/refuse—拒绝好友申请71
GET/im/friend-request/list—查询「我相关」的好友申请列表(游标分页:传 maxId 加载更多)81
GET/im/friend-request/pull—增量拉取「我相关」的好友申请(重连 / 离线补偿)94
GET/im/friend-request/get—按 id 单查「我相关」的申请记录(带越权过滤;WebSocket 通知到达后用)109

ImFriendRequestManagerController · 管理后台 - IM 好友申请管理 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/friend/ImFriendRequestManagerController.java

方法路径权限点摘要行
GET/im/manager/friend-request/pageim:manager:friend-request:query获得好友申请分页42

ImGroupController · 管理后台 - 群 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/group/ImGroupController.java

方法路径权限点摘要行
POST/im/group/create—创建群48
PUT/im/group/update—更新群56
DELETE/im/group/dissolve—解散群63
GET/im/group/get—获得群73
GET/im/group/list—获得当前登录用户的群列表81
POST/im/group/invite—邀请用户加入群91
DELETE/im/group/quit—退出群98
DELETE/im/group/kicking—移除群成员106
PUT/im/group/add-admin—添加群管理员113
PUT/im/group/remove-admin—撤销群管理员120
PUT/im/group/transfer-owner—转让群主127
PUT/im/group/pin-message—置顶群消息(群主 / 管理员)136
PUT/im/group/unpin-message—取消置顶群消息(群主 / 管理员)143
PUT/im/group/mute-all—全群禁言 / 取消(群主 / 管理员)152
PUT/im/group/mute-member—禁言成员159
PUT/im/group/cancel-mute-member—取消成员禁言166

ImGroupManagerController · 管理后台 - IM 群聊管理 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/group/ImGroupManagerController.java

方法路径权限点摘要行
GET/im/manager/group/pageim:manager:group:query获得群分页45
GET/im/manager/group/getim:manager:group:query获得群详情67
PUT/im/manager/group/banim:manager:group:ban封禁群76
PUT/im/manager/group/unbanim:manager:group:ban解封群84
DELETE/im/manager/group/dissolveim:manager:group:dissolve解散群93

ImGroupMemberController · 管理后台 - 群成员 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/group/ImGroupMemberController.java

方法路径权限点摘要行
PUT/im/group-member/update—更新群成员46
GET/im/group-member/get—获得群成员53
GET/im/group-member/list—获得指定群的成员列表(按群全量拉取,作为前端本地成员 cache 的完整基线)91

ImGroupMemberManagerController · 管理后台 - IM 群成员管理 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/group/ImGroupMemberManagerController.java

方法路径权限点摘要行
GET/im/manager/group/member/listim:manager:group:query获得群成员列表(含已退群成员,由前端按需过滤)41

ImGroupMessageController · 管理后台 - IM 群聊消息 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/message/ImGroupMessageController.java

方法路径权限点摘要行
POST/im/message/group/send—发送群聊消息33
GET/im/message/group/pull—拉取群聊消息(增量)40
PUT/im/message/group/read—标记群聊消息已读51
DELETE/im/message/group/recall—撤回群聊消息61
GET/im/message/group/get-read-user-ids—获取群消息已读用户列表69
GET/im/message/group/list—查询群聊历史消息78

ImGroupMessageManagerController · 管理后台 - IM 群聊消息 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/message/ImGroupMessageManagerController.java

方法路径权限点摘要行
GET/im/manager/message/group/pageim:manager:message:query获得群聊消息分页52
GET/im/manager/message/group/getim:manager:message:query获得群聊消息详情83

ImGroupRequestController · 管理后台 - IM 加群申请 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/group/ImGroupRequestController.java

方法路径权限点摘要行
POST/im/group-request/apply—申请加群61
PUT/im/group-request/agree—同意加群申请(群主或管理员)68
PUT/im/group-request/refuse—拒绝加群申请(群主或管理员)77
GET/im/group-request/unhandled-list—查询「我管理的所有群」下的未处理加群申请列表(不分页);前端 store 据此派生横幅红点 + Drawer 列表87
GET/im/group-request/pull—增量拉取「我管理的群」下的加群申请(重连 / 离线补偿)94
GET/im/group-request/list-by-group—查询指定群下的全部加群申请(含已处理);仅群主 / 管理员可查110
GET/im/group-request/get—按 id 单查申请记录(带越权过滤;WebSocket 通知到达后用)119

ImGroupRequestManagerController · 管理后台 - IM 加群申请管理 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/group/ImGroupRequestManagerController.java

方法路径权限点摘要行
GET/im/manager/group-request/pageim:manager:group-request:query获得加群申请分页48

ImPrivateMessageController · 管理后台 - IM 私聊消息 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/message/ImPrivateMessageController.java

方法路径权限点摘要行
POST/im/message/private/send—发送私聊消息33
GET/im/message/private/pull—拉取私聊消息(增量)41
PUT/im/message/private/read—标记私聊消息已读52
GET/im/message/private/max-read-message-id—查询对方已读到我发的最大消息 id62
DELETE/im/message/private/recall—撤回私聊消息70
GET/im/message/private/list—查询私聊历史消息78

ImPrivateMessageManagerController · 管理后台 - IM 私聊消息 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/message/ImPrivateMessageManagerController.java

方法路径权限点摘要行
GET/im/manager/message/private/pageim:manager:message:query获得私聊消息分页43
GET/im/manager/message/private/getim:manager:message:query获得私聊消息详情63

ImRtcCallController · 管理后台 - IM 实时通话 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/rtc/ImRtcCallController.java

方法路径权限点摘要行
POST/im/rtc/create—创建新通话;按 conversationType 区分私聊 / 群聊41
POST/im/rtc/invite—通话中追加邀请;仅群通话可用49
POST/im/rtc/join—加入已有群通话;用于胶囊条「加入」按钮56
POST/im/rtc/accept—接听通话64
POST/im/rtc/reject—拒绝通话72
POST/im/rtc/cancel—取消邀请;主叫接通前调用80
POST/im/rtc/leave—离开通话;接通后调用88
POST/im/rtc/no-answer-call-check—前端 RUNNING 端 timer 兜底;触发后端立即扫描该 room 的振铃超时(接口静默)96
GET/im/rtc/get-active-call—查询当前进行中的通话;用于群聊顶部「N 人正在通话」胶囊条104

ImRtcCallManagerController · 管理后台 - IM 通话记录 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/rtc/ImRtcCallManagerController.java

方法路径权限点摘要行
GET/im/manager/rtc/pageim:manager:rtc:query获得通话记录分页51
GET/im/manager/rtc/getim:manager:rtc:query获得通话记录详情59
GET/im/manager/rtc/participant-listim:manager:rtc:query获得通话参与者列表71

ImRtcLiveKitController · LiveKit Webhook 回调 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/rtc/ImRtcLiveKitController.java

方法路径权限点摘要行
POST/im/livekit/webhook—LiveKit Webhook 回调;接收成员离开 / 房间结束等事件做业务态兜底清理49

ImSensitiveWordManagerController · 管理后台 - IM 敏感词 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/sensitiveword/ImSensitiveWordManagerController.java

方法路径权限点摘要行
POST/im/manager/sensitive-word/createim:manager:sensitive-word:create新增敏感词43
PUT/im/manager/sensitive-word/updateim:manager:sensitive-word:update修改敏感词50
DELETE/im/manager/sensitive-word/deleteim:manager:sensitive-word:delete删除敏感词58
DELETE/im/manager/sensitive-word/delete-listim:manager:sensitive-word:delete批量删除敏感词67
GET/im/manager/sensitive-word/pageim:manager:sensitive-word:query获得敏感词分页78
GET/im/manager/sensitive-word/getim:manager:sensitive-word:query获得敏感词详情97

ImStatisticsManagerController · 管理后台 - IM 数据看板 ​

modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/statistics/ImStatisticsManagerController.java

方法路径权限点摘要行
GET/im/manager/statistics/overviewim:manager:statistics:query获得数据概览54
GET/im/manager/statistics/message-trendim:manager:statistics:query获得消息趋势(私聊 / 群聊双线)78
GET/im/manager/statistics/user-trendim:manager:statistics:query获得用户趋势(新增注册 / 日活双线)96
GET/im/manager/statistics/message-type-distributionim:manager:statistics:query获得内容类型分布(最近 30 天)114
GET/im/manager/statistics/group-size-distributionim:manager:statistics:query获得群规模分布126
GET/im/manager/statistics/top-sendersim:manager:statistics:query获得消息 TOP 发送者(最近 30 天)136