API MAP

即时通讯源码接口能力总览

基于当前 Go 后端、Flutter 客户端、Vue 管理后台和客服后台源码整理,按聊天、群聊、钱包、后台四个客户最关心的方向展示接口能力。

14+业务接口域
HTTP + WS实时通信链路
App / 后台全端源码联动
BASE /api/v1

统一接口版本,业务侧通过鉴权、角色、风控和限流分层访问。

/chat会话群组
/message消息同步
/wallet钱包会员
/admin后台运营
公开页只展示能力边界,完整参数、响应示例和调试集合以 Apifox 文档为准。
FOUR VIEWS

先按业务理解接口

客户选型时不需要先看代码细节,先确认聊天、群组、钱包和后台能不能支撑自己的产品形态。

01

聊天消息

覆盖单聊、消息发送、历史拉取、撤回、删除、编辑、转发、已读、表情回应、媒体列表和 WebSocket 实时推送。

/message/send/message/list/api/v1/ws
02

群聊频道

覆盖群组、频道、成员增删、角色设置、入群审批、邀请链接、禁言、群公告、消息置顶和聊天记录清理。

/chat/list/chat/:id/members/chat/:id/announcements
03

钱包会员

覆盖余额、交易流水、在线支付下单、充值单、提现、红包、转账、支付密码、会员套餐和购买链路。

/wallet/wallet/red-packet/send/wallet/membership
04

后台运营

覆盖用户、会话、消息检索、动态审核、举报、钱包财务、热更新、广播、系统配置和客服后台。

/admin/users/admin/wallet/service-admin
MODULES

当前源码已实现的接口模块

以下按公开官网可展示粒度整理,便于客户确认功能覆盖范围;生产项目的请求参数、鉴权方式和返回结构请在交付后结合 Apifox 与源码联调。

账号安全

/auth

登录、注册、用户名校验、刷新登录态、退出登录、修改密码、忘记密码、设备锁验证、二维码登录确认。

用户资料

/user

个人资料、隐私设置、两步验证、黑名单、设备会话、推送设置、账号注销、用户搜索、共同群组。

联系人

/contact

联系人列表、添加好友、删除联系人、联系人备注,配合资料页和会话页同步展示。

会话群组

/chat

单聊、群聊、频道、成员管理、入群审批、邀请加入、禁言、置顶、免打扰、群公告、会话搜索。

消息媒体

/message

消息发送、历史同步、撤回、删除、已读、表情回应、编辑、转发、语音转写、媒体与文件聚合。

端到端加密

E2EE

设备公钥注册、成员设备密钥拉取、兼容/严格加密模式,支持按项目策略控制消息密文链路。

动态广场

/moment

动态列表、详情、发布、编辑、删除、点赞、评论、热门话题、搜索、个人互动记录和屏蔽能力。

音视频

/call

语音/视频通话配置、通话凭证、发起、接听、拒绝、取消、结束和历史记录。

群会议

/meeting

创建会议、加入会议、入会审批、邀请成员、离开/结束会议、静音、移出成员、主持人转移和会议详情。

钱包财务

/wallet

钱包信息、支付密码、交易流水、充值、提现、在线支付订单、红包、转账、会员套餐和会员购买。

文件上传

/upload

图片、多图、视频、头像、语音和文件上传,配合后台上传限制与业务类型做权限控制。

公共配置

/app

App 启动设置、热更新检查与上报、发现页入口、官方身份校验、广播、用户协议和隐私政策。

系统设置

/user-settings

用户端官方联系人同步、官方客服资料读取与维护,用于官方客服和新用户承接场景。

实时链路

/ws

在线连接、新消息推送、已读同步、会话状态、配置变更和多设备状态刷新。

管理后台

/admin

管理员、用户、会话、消息、动态、举报、话题、违禁词、钱包、通话、热更新、广播和系统配置。

客服后台

/service-admin

官方客服登录、资料、看板、邀请码、邀请用户、欢迎语、手机号绑定和密码维护。

FLOWS

核心业务链路怎么跑

接口不是孤立清单,实际体验由 HTTP、WebSocket、数据库、缓存和异步任务一起完成。

登录到在线

账号登录、设备校验、实时连接

认证登录

客户端提交账号凭证,后端校验后建立登录态,并按项目设置进入绑定手机号、设备锁或二维码确认流程。

拉取配置

App 获取公共设置、协议、发现页入口、热更新策略和官方资源,保证首页与业务开关同步。

建立 WebSocket

登录态有效后建立实时连接,用于消息、会话状态、多设备同步和运营广播。

消息到达

发送、落库、广播、同步

消息构造

客户端根据文本、图片、视频、文件、语音、位置、红包或转账等类型构造消息。

后端处理

服务端完成会话权限、成员状态、加密模式、限流和存储处理,再进入实时广播链路。

多端同步

在线设备收到新消息、已读、撤回、编辑、表情回应等事件,离线设备可通过同步接口补齐。

钱包交易

充值、红包、转账、提现

安全校验

涉及资金动作时校验登录态、手机号策略、支付密码、余额、频率限制和钱包状态。

业务入账

在线支付、人工充值、红包领取、转账接收和会员购买都会形成订单或流水。

后台审核

提现、充值、退款和钱包配置在后台完成审核与运营管理,关键写操作受角色控制。

运营治理

后台配置、审核、客服承接

配置下发

后台维护注册策略、官方账号、发现入口、协议、上传限制、热更新和公告等可运营配置。

内容治理

动态、话题、违禁词、举报、会话和用户状态由后台统一查询与处理。

客服归属

客服后台通过邀请码、欢迎语和邀请关系承接新用户,适合售前、社群和私域运营场景。

ADMIN SIDE

后台接口能力矩阵

后台模块面向运营、审核、客服、财务和技术配置。官网只展示模块范围,不公开危险操作参数和生产配置字段。

接口前缀模块客户可理解能力公开展示边界
/admin/users用户管理用户列表、统计、资料维护、封禁/解封、冻结/解冻、踢下线、推送测试。展示能力,不公开批量处置参数和账号安全细节。
/admin/chats会话治理私聊、群聊、频道列表,成员查询,群状态治理,解散或移除成员。展示权限边界,不给出可直接执行的管理请求体。
/admin/messages消息检索管理端按条件搜索消息,配合举报、风控和客服定位问题。不展示真实用户内容、索引策略和敏感查询示例。
/admin/moments动态审核动态列表、统计、状态审核、删除,配合话题和违禁词管理。不公开审核绕过、批量删除或敏感词库内容。
/admin/reports举报处理举报列表、统计、处理与删除,支撑用户、动态和会话治理。不展示举报人隐私、处理凭证和内部备注。
/admin/wallet钱包财务钱包统计、用户钱包、流水、提现审核、充值审核、红包、转账、会员、支付配置。支付网关、回调、密钥和财务写操作仅在私有交付环境说明。
/admin/settings系统配置注册策略、官方资源、发现页、协议、推送、上传限制、热更新相关配置。公网页面不列出具体密钥字段、证书字段和内部开关值。
/admin/hot-update热更新补丁列表、灰度发布、暂停、回滚、执行上报查询。不公开补丁包地址、签名策略和灰度命中规则细节。
/admin/broadcast全局广播向在线用户发送公告,查询公告列表,清理历史公告。写操作仅限授权管理员,官网不提供调用示例。
/service-admin客服后台客服登录、个人资料、看板、邀请码、邀请用户、欢迎语。不展示客服账号、邀请归属规则细节和内部统计口径。
RISK CONTROL

官网展示与上线风险说明

这部分是给客户看的真实边界:能说明项目专业度,也避免把不该公开的接口细节放到线上。

鉴权与权限

用户、客服、管理员分层

用户端接口走登录态和手机号策略;后台接口走管理员鉴权、角色分层和写权限控制;演示环境应保持只读或隔离数据。

资金与支付

钱包接口必须私有化核对

充值、提现、红包、转账、会员购买涉及余额和订单状态,上线前需要完成支付回调、对账、限流、风控和人工审核流程。

敏感配置

密钥证书不放官网

短信、推送、音视频、支付网关、对象存储、热更新包等配置只在客户私有环境交付,不在公开网页暴露字段和值。

消息合规

内容与用户数据要做治理

消息、动态、文件、举报和后台检索应结合客户业务设置留存、审核、敏感词、用户协议和隐私政策。

实时链路

WebSocket 需压测与监控

在线人数、消息峰值、心跳、断线重连、离线补偿、推送补达和消息队列异常都要纳入上线验收。

二次开发

以源码和 Apifox 为交付准绳

官网是能力说明,最终联调以客户部署版本的源码、数据库迁移、环境配置和 Apifox 接口集合为准。

ARCHITECTURE

接口与数据层关系

当前项目是完整源码交付形态,不只是前端页面。客户拿到的是客户端、后端、后台、客服端和部署文档的一整套工程。

01

客户端请求

Flutter App、Web、桌面端和后台系统通过 HTTP 调用业务接口,通过 WebSocket 接收实时事件。

02

Go 后端处理

后端负责认证、权限、会话、消息、钱包、音视频、动态、配置、客服和后台运营逻辑。

03

数据与缓存

MySQL 承载用户、群组、钱包和配置;MongoDB 承载消息内容;Redis 支撑缓存、限流和短时状态。

04

异步与推送

消息队列和推送服务处理离线通知、后台任务、广播扩散和异常隔离。

需要完整接口参数和调试集合?

在线 Apifox 文档提供更细的接口分组、请求参数、响应结构和联调说明;正式部署时建议结合源码版本、演示环境和客户业务再做一次接口确认。

准备购买即时通讯源码?先看价格、体验演示,再发环境给客服评估。 看价格 体验演示 联系咨询