chengkai3
31 lines
700 B
Markdown
31 lines
700 B
Markdown
# API Service
|
||
|
||
FastAPI 后端服务，包含用户认证和 RBAC 权限控制。
|
||
|
||
## 核心能力
|
||
|
||
- JWT Access Token（默认 8 小时）
|
||
- Refresh Session（HttpOnly Cookie，默认 30 天，刷新轮换）
|
||
- RBAC（用户-角色-权限）
|
||
- 用户管理接口（需 `user.manage`）
|
||
|
||
## 本地开发
|
||
|
||
```bash
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate
|
||
python -m pip install -r api/requirements.txt
|
||
python -m uvicorn api.app.main:app --reload --host 0.0.0.0 --port 8000
|
||
```
|
||
|
||
## 主要接口
|
||
|
||
- `GET /health`
|
||
- `GET /api/v1/ping`
|
||
- `POST /api/v1/auth/register`
|
||
- `POST /api/v1/auth/login`
|
||
- `POST /api/v1/auth/refresh`
|
||
- `POST /api/v1/auth/logout`
|
||
- `GET /api/v1/auth/me`
|
||
- `GET /api/v1/users`
|