今日诗词API 上线

今日诗词 API 是本 API 的升级版,可以根据不同地点、时间、节日、季节、天气、景观、城市进行智能推荐古诗词。

官网: https://www.jinrishici.com/

本接口继续保留运营维护。

简介




古诗词·一言API是一个可以随机返回一句古诗词名句的接口。具有以下特点:

  • 快:使用 Vert.x Java 全异步框架开发,毫秒级稳定响应
  • 全:支持 svg / txt / json / png 调用,满足你在任何地方的调用需求
  • 多:收录将近10000条古诗词名句
  • 准:可以根据你的喜好,在指定的分类中进行随机返回

使用

API举例

API地址格式(仅支持https)

https://api.gushi.ci/{一级分类}/{二级分类(可选)}.{返回格式(可选)}

查看所有目前支持的分类:https://api.gushi.ci/

目前支持的后缀:.svg .txt .png .json 不加后缀默认返回 json

SVG 调用

<img src="https://api.gushi.ci/all.svg">

SVG后缀是我们推荐的最优调用方案,可以在部分论坛、任何博客、小程序内无损直接调用,并且可以一定程度上控制样式。缺点是部分老旧浏览器不支持。

你可以直接修改svg样式:

<img src="https://api.gushi.ci/all.svg" style="max-width:100%; ">

或者使用我们的svg专用的自定义参数 个性化参数

说明 参数名 默认值 合法范围
字体大小(px) font-size 20 [8,50]
字体间隔(px) spacing 1.5 [0,30]

调用示例

<img src="https://api.gushi.ci/all.svg?font-size=18&spacing=4">

JSON 调用

<script> var xhr = new XMLHttpRequest(); xhr.open('get', 'https://api.gushi.ci/all.json'); xhr.onreadystatechange = function () { if (xhr.readyState === 4) { var data = JSON.parse(xhr.responseText); var gushici = document.getElementById('gushici'); gushici.innerText = data.content; } }; xhr.send(); </script>

JSON调用可以获取来源、作者、分类等信息,可以供你自定义拼接显示效果。

PNG 调用

<img src="https://api.gushi.ci/all.png">

我们会提供透明的PNG文件。PNG方法兼容性最好,可以在几乎任何地方插入。并且支持所有浏览器。缺点是不能控制样式,另外,由于流量限制,我们只会给您传送较小的图片源文件。

TXT 调用

<script> var xhr = new XMLHttpRequest(); xhr.open('get', 'https://api.gushi.ci/all.txt'); xhr.onreadystatechange = function () { if (xhr.readyState === 4) { var gushici = document.getElementById('gushici'); gushici.innerText = xhr.responseText; } }; xhr.send(); </script>

TXT调用和JSON调用基本一致,可以节省一些流量。或者,你甚至可以使用 iframe 来调用我们的接口

关于

这是我的个人项目,目的是为了弘扬中国传统文化。

本项目开源并且托管在 Github 上: https://github.com/xenv/gushici

本人不接受捐助,但恳请不要使用 DDOS 等方法攻击本站。

名句数据由古诗文网收录整理,特此感谢。

若有任何建议,或者有工作实习的机会(本人大学在读),请联系 meetlhx#qq.com

若您对本人的其他作品或者文章感兴趣,请访问我的博客:https://luan.ma