📜 宋词API接口文档

本API提供300首经典宋词的查询服务，支持随机获取、条件筛选等功能。

📋 接口列表

{
  "code": 200,
  "message": "success",
  "data": {
    "id": 1,
    "cipai": "水调歌头",
    "author": "苏轼",
    "dynasty": "北宋",
    "title": "水调歌头·明月几时有",
    "content": ["明月几时有？把酒问青天。", ...],
    "formatted": "<div class='songci-card'>..."
  }
}

// 示例：获取ID为1的宋词
GET /api/songci/1

// 示例：查询苏轼的词，第1页，每页5首
GET /api/songci/list?author=苏轼&page=1&limit=5

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 200,
    "cipaiCount": 50,
    "authorCount": 30,
    "dynastyStats": {
      "北宋": 80,
      "南宋": 70,
      ...
    }
  }
}

💻 使用示例

JavaScript Fetch

// 获取随机宋词
fetch('http://localhost:3000/api/songci/random')
  .then(response => response.json())
  .then(data => {
    console.log(data.data);
  });

// 按作者查询
fetch('http://localhost:3000/api/songci/list?author=苏轼')
  .then(response => response.json())
  .then(data => {
    console.log(data.data);
  });

cURL

# 获取随机宋词
curl http://localhost:3000/api/songci/random

# 查询李清照的词
curl "http://localhost:3000/api/songci/list?author=李清照"

🎨 前端嵌入

可以直接访问主页查看古风卡片展示效果：

http://localhost:3000

📝 数据结构说明