palemoky/chinese-poetry-api

Что это?

Ключевые возможности

• 01Предоставляет REST- и GraphQL API для стихотворений, авторов, династий и жанров.
• 02Позволяет переключаться между упрощённым и традиционным китайским с помощью параметра lang.
• 03Поддерживает полнотекстовый поиск и поиск по названию, тексту или автору.
• 04Позволяет получать случайные стихотворения и фильтровать их, в том числе по отдельным иероглифам.
• 05Включает ограничение частоты запросов по IP и пагинацию на основе курсора.
• 06Поставляется в виде Docker-образа для amd64 и arm64.

Сценарии использования

• Добавить поиск классической поэзии или цитаты в приложение либо на сайт.
• Создать игру 飞花令 или поэтическую викторину со случайными запросами и фильтрацией по иероглифам.
• Практиковаться в веб-скрейпинге на реалистичном источнике данных, размещённом самостоятельно.
• Запрашивать данные о китайской поэзии на традиционном или упрощённом письме.

Быстрый старт

1. 1

   Запустить с помощью Docker

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

   Клонировать репозиторий вместе с подмодулями

   git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git
3. 3

   Обработать данные и запустить сервер с помощью Makefile

   make process-data
4. 4

   Запустить сервер

   make run-server

Что важно знать

• !Данные Poetry берутся из подмодулей, поэтому необходимо клонировать репозиторий вместе с ними или получить их отдельно.
• !При работе с Makefile перед запуском сервера необходимо выполнить обработку данных.

Темы

Частые вопросы

Что такое chinese-poetry-api?

API-сервис на Go для классической китайской поэзии с REST- и GraphQL-эндпоинтами и корпусом почти из 400 000 стихотворений на упрощённом и традиционном китайском. chinese-poetry-api — сервис на Go, который предоставляет доступ к базе классической китайской поэзии: стихам эпохи Тан, словам песен эпохи Сун, песням юаньской драмы и другим жанрам. В базе почти 400 000 произведений. Стихотворения можно просматривать и фильтровать по династии, автору или жанру, искать по названию, тексту или автору, а также получать случайным образом. Поддерживаются и фильтры по отдельным иероглифам — например, для игр вроде 飞花令.

chinese-poetry-api можно использовать бесплатно? Какая у него лицензия?

chinese-poetry-api распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

chinese-poetry-api всё ещё поддерживается?

Активно поддерживается. Последний коммит в chinese-poetry-api — 7 окт. 2026 г..

Для чего можно использовать chinese-poetry-api?

Добавить поиск классической поэзии или цитаты в приложение либо на сайт. Создать игру 飞花令 или поэтическую викторину со случайными запросами и фильтрацией по иероглифам. Практиковаться в веб-скрейпинге на реалистичном источнике данных, размещённом самостоятельно. Запрашивать данные о китайской поэзии на традиционном или упрощённом письме.

Как установить chinese-poetry-api?

Запустить с помощью Docker: docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest Клонировать репозиторий вместе с подмодулями: git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git Обработать данные и запустить сервер с помощью Makefile: make process-data Запустить сервер: make run-server

Где скачать chinese-poetry-api?

Исходный код и инструкции по установке — на GitHub: https://github.com/palemoky/chinese-poetry-api