开源高性能中国古诗词 API 服务，收录了 37 万多首诗词，覆盖 1.3 万多位诗人。

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（推荐）

1. docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest

复制代码

完整配置参见 docker-compose.yml。

使用 Makefile

1. make help          # 查看所有可用命令
   
2. make build         # 构建项目
   
3. make process-data  # 处理数据
   
4. make run-server    # 启动服务

复制代码

克隆仓库

本项目使用 Git Submodules 管理诗词数据，推荐使用以下命令快速克隆：

1. # 完整克隆（包含 submodules）
   
2. git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git

复制代码

如果已经克隆了仓库，可以单独更新 submodules：

1. git submodule update --init

复制代码