控制台指南
开发者控制台(/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 是否正确,聊天室消息不落库。