SoftUnis ecb29e0aa4 初始化 MengStack 官方网站仓库

包含 VitePress 文档站完整源码及全新自定义首页设计：
- 自定义首页组件 (Home.vue)：Hero + 终端动效 + 核心能力 + 架构展示 + 快速开始 + CTA
- 自定义 Layout.vue：首页/文档页布局切换
- 金铜色品牌主题样式
- 完整文档页面（指南、API、更新日志、演示、社区）
- SEO 配置（sitemap、robots、meta 标签）

2026-10-02 23:37:25 +08:00

2.6 KiB

Raw Blame History

认证接口

用户注册

注册新用户并返回 JWT 令牌。

POST /api/v1/auth/register

请求体

{
  "email": "user@example.com",
  "username": "johndoe",
  "nickname": "John Doe",
  "password": "securepass123"
}

字段	类型	必填	约束
`email`	string	是	有效邮箱格式
`username`	string	是	3-64 字符
`nickname`	string	否	-
`password`	string	是	8-128 字符

响应

{
  "code": 0,
  "message": "success",
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIs...",
    "refresh_token": "eyJhbGciOiJIUzI1NiIs...",
    "expires_in": 7200
  },
  "trace_id": "req-abc-123"
}

错误

状态码	说明
400	参数校验失败
409	邮箱或用户名已存在

用户登录

使用邮箱和密码登录。

POST /api/v1/auth/login

请求体

{
  "email": "user@example.com",
  "password": "securepass123"
}

字段	类型	必填
`email`	string	是
`password`	string	是

响应

同注册接口，返回 TokenPair。

错误

状态码	说明
400	参数校验失败
401	邮箱或密码错误

刷新令牌

使用 refresh_token 获取新的令牌对。

POST /api/v1/auth/refresh

请求体

{
  "refresh_token": "eyJhbGciOiJIUzI1NiIs..."
}

响应

同注册接口，返回新的 TokenPair。

错误

状态码	说明
400	参数校验失败
401	Refresh Token 无效或过期

修改密码

修改当前用户密码，需要认证。

POST /api/v1/password

请求头

Authorization: Bearer <access_token>
X-Tenant-ID: <tenant_id>

请求体

{
  "old_password": "oldpass123",
  "new_password": "newpass456"
}

字段	类型	必填	约束
`old_password`	string	是	-
`new_password`	string	是	8-128 字符

响应

{
  "code": 0,
  "message": "success",
  "data": null,
  "trace_id": "req-abc-123"
}

获取当前用户

获取当前认证用户的个人资料。

GET /api/v1/profile

请求头

Authorization: Bearer <access_token>
X-Tenant-ID: <tenant_id>

响应

{
  "code": 0,
  "message": "success",
  "data": {
    "id": 1,
    "email": "user@example.com",
    "username": "johndoe",
    "nickname": "John Doe",
    "avatar": "",
    "status": 1,
    "tenant_id": "tenant-001"
  },
  "trace_id": "req-abc-123"
}

2.6 KiB Raw Blame History