控制台指南

开发者控制台(/console/)面向应用开发者,用于管理应用与 AppKey、用户、群组、聊天室、消息、回调与敏感词。本页按功能模块说明使用方式。

入口

启动服务后访问 http://127.0.0.1:8080/console/;控制台使用 X-Admin-Secret 访问 Admin API。

应用与密钥​

  • 创建应用后获得 AppKey 与 AppSecret;AppSecret 仅服务端持有,用于 Open API 签名;
  • 支持多应用隔离:不同 AppKey 的用户、群组、消息互不可见;
  • 可查看应用状态、服务开通情况(单聊/群聊/聊天室)与用量。

用户管理​

支持注册测试用户、批量导入用户、查询用户资料与在线状态。对应接口:

操作接口
注册用户POST /api/admin/apps/{appkey}/users
批量导入POST /api/admin/apps/{appkey}/users/batch
在线连接GET /api/admin/apps/{appkey}/connections

消息与会话​

  • 按用户、会话类型、关键字与时间范围查询消息;
  • 以系统身份向指定用户/群组发送消息;
  • 查看消息投递与回调记录,定位“已发送未收到”的问题。

回调与推送​

配置通用回调 URL 与离线推送 Webhook,查看回调投递日志与失败重试。事件列表见 回调服务。

敏感词​

按行维护敏感词列表,支持过滤/替换策略;命中记录可在消息查询中检索。

统计​

控制台展示消息量、DAU、在线峰值等指标;数据源为 Admin API 的统计接口。

常见问题​

  • 控制台 401:检查 Admin Secret 是否与服务端一致;
  • 应用列表为空:确认服务端已启动并完成初始化数据;
  • 消息查询为空:确认时间范围与用户 ID 是否正确,聊天室消息不落库。