docs: 更新 API 文档,澄清 get_weather_details 支持双认证方式

- 说明 get_weather_details 同时支持 JWT 和 temp_token
- 更新路由注册注释
This commit is contained in:
2026-04-18 13:24:07 +08:00
parent 7eb8d1b5c2
commit d756694534

View File

@@ -109,14 +109,13 @@ title, date, hour, min, longitude, latitude, ...
### 公开接口(无需认证)
- `POST /api/login` — 微信登录
- `GET /weather/details?temp_token=...` — 通过临时令牌访问
- `GET /weather/details` — 获取天气详情(支持 JWT 或 temp_token详见下文
- `GET /static/{tail:*}` — 静态文件
### 受保护接口(需要 JWT
- `POST /api/post-weather-data` — 上传天气数据(带配额检查)
- `GET /api/user/profile` — 获取当前用户信息(付费状态、管理员标识)
- `GET /weather` — 分页列出用户的天气数据
- `GET /weather/details?id=...` — 获取天气详情JWT 认证)
- `POST /api/generate-temp-token/{resource_id}` — 生成 10 分钟分享令牌
- `DELETE /weather/delete/{id}` — 删除天气记录
@@ -293,7 +292,7 @@ App::new()
.app_data(web::Data::new(app_state))
// 公开接口(无 middleware
.service(login) // POST /api/login
.service(get_weather_details) // GET /api/weather/details
.service(get_weather_details) // GET /weather/details(支持 JWT 或 temp_token
// 受保护接口JWT middleware
.service(
web::scope("")