# 接口文档（JWT，无状态 API）

基地址：`http://localhost:8000/api`（容器默认映射 8000 端口）  
自然语言：中文

- 认证方式：在请求头添加 `Authorization: Bearer {token}`。
- 默认账号（来自 `php artisan db:seed`）：`root@example.com` / `Root@123456`。
- 所有接口均返回 JSON；失败时返回 `{ "message": "错误信息" }`。
- 跨域：默认允许 `http://localhost:5173`，可通过环境变量 `CORS_ALLOWED_ORIGINS`（逗号分隔多个域名）调整。

## 健康检查
- `GET /health`  
  响应：`{ "status": "ok" }`

## 登录
- `POST /login`
- 请求体：
```json
{ "email": "user@example.com", "password": "Password123" }
```
- 响应 200：
```json
{
  "token": "jwt-token",
  "token_type": "bearer",
  "expires_in": 3600,
  "user": { "id": 1, "name": "root", "email": "root@example.com", "is_active": true }
}
```
- 401：凭证无效；403：用户已停用。

## 当前用户
- `GET /me`（需要 JWT）
- 响应 200：当前登录用户信息。

## 用户管理（需 JWT）
字段约束：`name` 必填字符串（<=255）、`email` 邮箱唯一、`password` 最少 8 字符。

### 用户列表
- `GET /users`
- 查询参数：`page`（默认 1）、`per_page`（默认 15，最大 100）
- 响应 200：分页列表，`data` 为用户数组，包含 `id/name/email/is_active/created_at/updated_at`。

### 创建用户
- `POST /users`
- 请求体：
```json
{ "name": "Alice", "email": "alice@example.com", "password": "Password123" }
```
- 响应 201：新建用户（含 `is_active: true`）。

### 更新用户
- `PUT /users/{id}`
- 请求体（任意字段可选）：
```json
{ "name": "New Name", "email": "new@example.com", "password": "NewPass123" }
```
- 响应 200：更新后的用户。

### 停用用户
- `POST /users/{id}/deactivate`
- 响应 200：`is_active` 为 `false`。

### 启用用户
- `POST /users/{id}/activate`
- 响应 200：`is_active` 为 `true`。

## 示例（cURL）
```bash
# 登录
curl -X POST http://localhost:8000/api/login \
  -H "Content-Type: application/json" \
  -d '{"email":"root@example.com","password":"Root@123456"}'

# 创建用户（替换 TOKEN）
curl -X POST http://localhost:8000/api/users \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Alice","email":"alice@example.com","password":"Password123"}'

# 获取用户列表（替换 TOKEN）
curl -X GET http://localhost:8000/api/users \
  -H "Authorization: Bearer TOKEN"
```