古诗 API - 接口文档

GET /api/random 随机诗句

从全唐诗、宋词、元曲等 13 个合集中随机返回一句诗句，支持合集与作者筛选。

请求参数

参数	类型	说明
collection	string	合集标识，如 `tangshi`，不传则全合集随机 (可选)
author	string	按作者筛选，如 `李白` (可选)
full	string	设为 `true` 返回完整诗词 (可选)

合集列表

标识	名称
tangshi	全唐诗
songci	宋词
yuanqu	元曲
shijing	诗经
lunyu	论语
chuci	楚辞
caocao	曹操诗集
nalan	纳兰性德
youmengying	幽梦影
shuimo	水墨唐诗
huajianji	花间集
nantang	南唐
yuding	御定全唐诗

调用示例

# 随机诗句
curl https://poetry.api.zyhh.qzz.io/api/random

# 指定合集
curl https://poetry.api.zyhh.qzz.io/api/random?collection=songci

# 筛选作者 + 完整诗词
curl "https://poetry.api.zyhh.qzz.io/api/random?author=李白&full=true"

响应示例

        {
  "quote":    "床前明月光，疑是地上霜",
  "title":   "静夜思",
  "author":  "李白",
  "collection": "全唐诗",
  "collectionKey": "tangshi"
}
      

GET /api/collections 合集列表

获取所有合集的名称与文件数量。

请求参数

无参数

调用示例

curl https://poetry.api.zyhh.qzz.io/api/collections

响应示例

        {
  "tangshi": { "name": "全唐诗", "files": 312 },
  "songci":  { "name": "宋词",  "files": 23 },
  "yuanqu": { "name": "元曲",  "files": 1 }
}
      