返回 总览
| 方法 | 路径 | 认证 | 说明 | 详情 |
|---|---|---|---|---|
| POST | /api/v1/users/verification-code |
公开 | 发送验证码 | auth/send-verification-code |
| POST | /api/v1/users/register |
公开 | 注册 | auth/register |
| POST | /api/v1/users/login |
公开 | 登录 | auth/login |
| POST | /api/v1/users/refresh-token |
公开 | 刷新令牌 | auth/refresh-token |
| GET | /api/v1/users/me |
需认证 | 获取个人资料 | auth/get-profile |
| PUT | /api/v1/users/me/profile |
需认证 | 更新个人资料 | auth/update-profile |
| POST | /api/v1/users/me/bind-email |
需认证 | 绑定邮箱 | auth/bind-email |
| PUT | /api/v1/users/me/email |
需认证 | 修改邮箱 | auth/change-email |
| GET | /api/v1/users/verify-email |
公开 | 验证邮箱 | auth/verify-email |
| POST | /api/v1/users/forgot-password |
公开 | 忘记密码 | auth/forgot-password |
| POST | /api/v1/users/reset-password |
公开 | 重置密码 | auth/reset-password |
| PUT | /api/v1/users/me/password |
需认证 | 修改密码 | auth/change-password |
| POST | /api/v1/users/me/deletion |
需认证 | 注销账户 | auth/delete-account |
| POST | /api/v1/regions |
需认证 | 创建区域 | regions/create |
| GET | /api/v1/regions |
需认证 | 查询区域列表 | regions/list |
| PUT | /api/v1/regions/order |
需认证 | 区域重排序 | regions/order |
| PUT | /api/v1/regions/{id} |
需认证 | 更新区域 | regions/update |
| DELETE | /api/v1/regions/{id} |
需认证 | 删除区域 | regions/delete |
| POST | /api/v1/locations |
需认证 | 创建位置 | locations/create |
| GET | /api/v1/locations |
需认证 | 按区域查位置 | locations/list |
| PUT | /api/v1/locations/order |
需认证 | 位置重排序 | locations/order |
| PUT | /api/v1/locations/{id} |
需认证 | 更新位置 | locations/update |
| DELETE | /api/v1/locations/{id} |
需认证 | 删除位置 | locations/delete |
| POST | /api/v1/plant-species |
需 ADMIN | 创建种类 | plant-species/create |
| GET | /api/v1/plant-species |
公开 | 查询种类列表 | plant-species/list |
| GET | /api/v1/plant-species/{id} |
公开 | 查询种类详情 | plant-species/get |
| PUT | /api/v1/plant-species/{id} |
需 ADMIN | 更新种类 | plant-species/update |
| DELETE | /api/v1/plant-species/{id} |
需 ADMIN | 删除种类 | plant-species/delete |
| POST | /api/v1/plants |
需认证 | 创建植物 | plants/create |
| GET | /api/v1/plants |
需认证 | 查询植物列表 | plants/list |
| GET | /api/v1/plants/{id} |
需认证 | 查询植物详情 | plants/get |
| PUT | /api/v1/plants/{id} |
需认证 | 更新植物 | plants/update |
| DELETE | /api/v1/plants/{id} |
需认证 | 删除植物 | plants/delete |
| POST | /api/v1/plant-tags |
需认证 | 创建标签 | plant-tags/create |
| GET | /api/v1/plant-tags |
需认证 | 查询标签列表 | plant-tags/list |
| PUT | /api/v1/plant-tags/{id} |
需认证 | 重命名标签 | plant-tags/update |
| DELETE | /api/v1/plant-tags/{id} |
需认证 | 删除标签 | plant-tags/delete |
| POST | /api/v1/plant-journals |
需认证 | 创建养护记录 | plant-journals/create |
| GET | /api/v1/plant-journals |
需认证 | 查询养护记录列表 | plant-journals/list |
| GET | /api/v1/plant-journals/{id} |
需认证 | 查询养护记录详情 | plant-journals/get |
| PUT | /api/v1/plant-journals/{id} |
需认证 | 更新养护记录 | plant-journals/update |
| DELETE | /api/v1/plant-journals/{id} |
需认证 | 删除养护记录 | plant-journals/delete |
| POST | /api/v1/media |
需认证 | 上传媒体文件 | media/upload |
| GET | /api/v1/media/** |
公开 | 访问媒体文件（可选 ?w&h&format&q&resize 按需缩放/转码） |
media/serve |
| GET | /.well-known/jwks.json |
公开 | JWKS 公钥集 | admin/rotate-jwt-key |
| POST | /api/v1/feedbacks |
需认证 | 提交反馈 | feedbacks/submit |
| POST | /api/v1/admin/jwt/rotate |
需 ADMIN | 轮换 JWT 密钥 | admin/rotate-jwt-key |