chinese-poetry-api 基于 Go 语言的高性能中国古诗词 API 服务,支持 REST 和 GraphQL 接口,提供简体/繁体中文、爬虫练习场等功能。
Github地址
https://github.com/palemoky/chinese-poetry-api
开源高性能中国古诗词 API 服务,收录了 37 万多首诗词,覆盖 1.3 万多位诗人。 ... ...
功能特性
随机抽一首诗词出来,可以指定要李白的、要唐代的、要七言绝句的,或者这几个条件叠在一起
全文搜索,输入"春风"这类关键词,返回包含该词的诗作
列出所有作者、朝代、体裁,方便你做分类导航
看数据统计,了解库里到底有多少首诗、多少位诗人
所有接口后面加个 lang=zh-Hans 或 lang=zh-Hant 参数,简体繁体直接切换
支持在线调试页面,点几下就能生成 cURL、Python、JavaScript 等代码片段
快速开始
使用 Docker(推荐)
- docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest
复制代码
完整配置参见 docker-compose.yml。
使用 Makefile
- make help # 查看所有可用命令
- make build # 构建项目
- make process-data # 处理数据
- make run-server # 启动服务
复制代码
克隆仓库
本项目使用 Git Submodules 管理诗词数据,推荐使用以下命令快速克隆:
- # 完整克隆(包含 submodules)
- git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git
复制代码
如果已经克隆了仓库,可以单独更新 submodules:
- git submodule update --init
复制代码 |