增加一次性群邀请链接和二维码

This commit is contained in:
xhgit committed 2026-11-15 18:02:28 +08:00
1 parent dfeb5bfefa
commit 5ec9c81f90
18 files changed
+727 -14

No files matched your search

+4
View File
@@ -30,6 +30,8 @@
| GET / POST | /api/v1/groups/{id} | 查看群组详情或执行邀请、接受、拒绝、改名、升降管理员、转让群主、移除、退出或解散 |
| POST | /api/v1/groups/{id}/preferences | 更新当前账号的 `pinned` 和 `muted`,可只传其中一项 |
| POST | /api/v1/groups/{id}/seen | 提交当前设备已同步的消息游标 `sequence`,成功返回 204 |
| POST / DELETE | /api/v1/groups/{id}/invite-link | 群主生成或撤销一次性链接。生成返回 `code` 和 `expiresAt`,撤销返回 204 |
| POST | /api/v1/group-invites/redeem | 登录后提交 `code`,成功返回 `groupId`,供用户打开邀请并接受或拒绝 |
| GET | /api/v1/groups/{id}/devices | 获取群成员的有效设备与 MLS 公钥 |
| POST | /api/v1/groups/{id}/devices/{device}/claim | 群主一次性领取群成员设备的 KeyPackage |
| GET / POST | /api/v1/groups/{id}/epochs | 读取当前设备可访问的会话信息或由群主发布新世代 |
@@ -54,6 +56,8 @@ MLS 凭据由标准 Base64 的 publicKey 和 signature 组成,使用 UTF-8 前
群主可使用 `transfer` 和有效成员的 `target` 转让群主。转让会将原群主设为普通成员,更新群版本,由新群主创建后续 MLS 会话。公告使用现有 MLS 密文投递接口,客户端验证公告来自该会话经核验的群主设备。
邀请链接有效 24 小时,重新生成、撤销或群主转让会使当前链接失效。服务端保存邀请码的 SHA-256 摘要。单次领取和创建待接受邀请在同一事务内完成,领取后须接受邀请才可访问成员和加密会话。链接使用 URL 片段,客户端在确认领取时才把邀请码发给当前服务。
创建或更新群资料和成员后,受影响账号的在线客户端收到 `{"type":"group_list_changed"}`,再用授权 API 刷新。邀请相关提示发送给管理者和被邀请人。提示只包含类型字段,不传群号、群名或成员资料。
群组密文投递使用 `/groups/{id}/epochs` 和 `/groups/{id}/messages`。群主发布带 membershipVersion 的世代,选取每个有效成员的一台已登记 MLS 设备,提交其他设备的 Welcome。GET epochs 返回当前有效世代的设备名单和本设备获准接收的 Welcome,旧世代仅向在本次成员资格期间加入过该世代的设备返回。POST messages 接受当前世代的 MLS PrivateMessage,GET messages 通过 after 游标返回本设备有权读取的密文。