留言板

管理留言的接口。

获取留言列表

获取所有公开的留言。

接口信息

• 请求路径: GET /api/wall-messages
• 认证方式: 无需认证（公开接口）

查询参数

参数名	类型	必填	说明
page	number	否	页码，默认 1
limit	number	否	每页数量，默认 20

创建留言

提交新留言。

接口信息

• 请求路径: POST /api/wall-messages
• 认证方式: 可选（登录用户会记录用户信息）

请求参数

参数名	类型	必填	说明
nickname	string	是	昵称（未登录用户必填）
content	string	是	留言内容
email	string	否	邮箱
website	string	否	网站链接

请求示例

curl -X POST http://localhost:3000/api/wall-messages \
  -H "Content-Type: application/json" \
  -d '{
    "nickname": "访客",
    "content": "留言内容",
    "email": "guest@example.com"
  }'

响应示例（留言列表）

{
  "success": true,
  "data": [
    {
      "id": 1,
      "nickname": "访客",
      "content": "留言内容",
      "avatar": "https://example.com/avatar.jpg",
      "createdAt": "2024-01-15T10:00:00.000Z"
    }
  ],
  "total": 50,
  "page": 1,
  "limit": 20
}

错误响应

HTTP 状态码	说明
400	参数错误
500	服务器错误

限制说明

• 留言内容最多 500 字符
• 昵称最多 50 字符
• 邮箱需要格式验证
• 网站链接需要格式验证