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