docs: 更新 API 文档,澄清 get_weather_details 支持双认证方式
- 说明 get_weather_details 同时支持 JWT 和 temp_token - 更新路由注册注释
This commit is contained in:
@@ -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("")
|
||||
|
||||
Reference in New Issue
Block a user