70 lines
1.3 KiB
Markdown
70 lines
1.3 KiB
Markdown
|
# Quickstart（最小可运行示例）
|
|||
|
|
|
|||
|
|
以下步骤使用内存存储启动服务，适合本地快速验证 API 行为。
|
|||
|
|
|
|||
|
|
## 1. 准备最小配置
|
|||
|
|
|
|||
|
|
创建 `config/local.yaml`：
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
mode: "server"
|
|||
|
|
log:
|
|||
|
|
level: info
|
|||
|
|
server:
|
|||
|
|
addr: ":8080"
|
|||
|
|
store:
|
|||
|
|
driver: "memory"
|
|||
|
|
dsn: ""
|
|||
|
|
session:
|
|||
|
|
ttl: 24h
|
|||
|
|
smtp:
|
|||
|
|
host: ""
|
|||
|
|
port: 587
|
|||
|
|
username: ""
|
|||
|
|
password: ""
|
|||
|
|
from: ""
|
|||
|
|
replyTo: ""
|
|||
|
|
timeout: 10s
|
|||
|
|
tls:
|
|||
|
|
mode: "auto"
|
|||
|
|
insecureSkipVerify: false
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
说明：
|
|||
|
|
- `store.driver=memory` 可跳过数据库
|
|||
|
|
- `smtp.host=""` 会关闭邮件验证
|
|||
|
|
|
|||
|
|
## 2. 启动服务
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
go run ./cmd/accountsvc/main.go --config config/local.yaml
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 3. 健康检查
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl http://localhost:8080/healthz
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 4. 注册与登录
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 注册
|
|||
|
|
curl -X POST http://localhost:8080/api/auth/register \
|
|||
|
|
-H 'Content-Type: application/json' \
|
|||
|
|
-d '{"name":"demo","email":"demo@example.com","password":"Passw0rd!"}'
|
|||
|
|
|
|||
|
|
# 登录
|
|||
|
|
curl -X POST http://localhost:8080/api/auth/login \
|
|||
|
|
-H 'Content-Type: application/json' \
|
|||
|
|
-d '{"identifier":"demo@example.com","password":"Passw0rd!"}'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
成功登录后返回 `token`，后续可使用：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -H 'Authorization: Bearer <session-token>' http://localhost:8080/api/auth/session
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
> 注意：会话保存在进程内存，重启服务会使会话失效。
|