这些接口用于控制台账号认证。第三方登录方式只有在 青云TOP API 页面显示并启用时才可用。
账号密码
| 方法 | 路径 | 用途 |
|---|---|---|
GET | /api/verification | 发送邮箱验证码 |
POST | /api/user/register | 注册账号 |
POST | /api/user/login | 用户登录 |
POST | /api/user/auth/logout | 撤销当前登录会话 |
GET | /api/reset_password | 发送密码重置邮件 |
POST | /api/user/reset | 使用验证码重置密码 |
POST | /api/user/login/2fa | 完成两步验证登录 |
GET | /api/user/groups | 获取注册或登录页面可选的用户分组 |
Passkey 登录
| 方法 | 路径 | 用途 |
|---|---|---|
POST | /api/user/passkey/login/begin | 获取 Passkey 登录挑战 |
POST | /api/user/passkey/login/finish | 提交浏览器返回的验证结果 |
Passkey 的 begin 和 finish 必须在同一次浏览器认证流程中配对调用，不要手工构造验证器返回值。
OAuth 登录
| 方法 | 路径 | 用途 |
|---|---|---|
POST | /api/oauth/state | 生成 OAuth State |
GET | /api/oauth/github | GitHub 登录 |
GET | /api/oauth/discord | Discord 登录 |
GET | /api/oauth/oidc | OIDC 登录 |
GET | /api/oauth/linuxdo | LinuxDO 登录 |
GET | /api/oauth/telegram/login | Telegram 登录 |
POST | /api/oauth/telegram/bind/start | 创建 Telegram 绑定流程 |
GET | /api/oauth/telegram/bind/{flow_token} | 完成 Telegram 绑定流程 |
GET | /api/oauth/wechat | 微信登录 |
POST | /api/oauth/wechat/bind | 绑定微信 |
POST | /api/oauth/email/bind | 绑定邮箱 |
青云TOP API 只开放控制台当前显示的提供商。客户端应先读取页面状态，不要写死某个平台一定可用。