24 lines
777 B
Markdown
24 lines
777 B
Markdown
# OpenAPI 草案（完整）
|
||
|
||
已補上完整端點與資料結構，並提供 `docs/openapi.yaml` 作為可直接擴充的版本。
|
||
|
||
## 版本
|
||
- OpenAPI: 3.1.0
|
||
- 檔案：`docs/openapi.yaml`
|
||
|
||
## 核心資源
|
||
- OAuth2/OIDC：授權、token、discovery、JWKS
|
||
- Auth：註冊、登入（password grant）、刷新、登出、忘記/重設密碼、Email 驗證
|
||
- User：個人資料
|
||
- Newsletter：訂閱/確認/退訂/偏好
|
||
- Admin：Tenants/Lists/OAuth Clients（MVP CRUD）
|
||
|
||
## Security Schemes
|
||
- OAuth2 (Authorization Code + PKCE)
|
||
- Bearer JWT（API 使用）
|
||
|
||
## 補充說明
|
||
- `/oauth/token`、`/auth/login`、`/auth/refresh` 使用 `application/x-www-form-urlencoded`
|
||
- `/auth/email/verify` 需要 `token` + `email`
|
||
- `/newsletter/subscribe` 會回傳 `confirm_token`
|