今日诗词 | 一个诗词一言API

先上官网:

官网长这样,一眼望去就是诗词:


调用很方便,稍微整理了下简单的:

点击打开今日诗词API接入方式

HTML

在 HTML 中需要加载诗词的地方放置以下加载代码即可,和 网站统计 的安装方法一致。

<span id="jinrishici-sentence">正在加载今日诗词....</span>
<script src="https://sdk.jinrishici.com/v2/browser/jinrishici.js" charset="utf-8"></script>

SDK 会自动寻找 id 或者 classjinrishici-sentence 的标签,将里面的内容替换为诗词

如果需要在多个地方显示诗词,添加多个 class=" jinrishici-sentence " 的 span 即可

捷径/浏览器插件接口

如果您用浏览器直接打开我们的接口地址,则自动使用我们的浏览器直接访问接口(原标准 JSON 接口),我们会自动向您发送一个 Cookies,作用和 Token 等效。

https://v2.jinrishici.com/one.json

此接口 仅适用于浏览器直接访问不适用于网站调用 ,应用场景包括:浏览器插件、IOS 捷径访问。如果您贪方便在其他地方直接调用本接口,可能会触发我们的系统判断,导致诗词推荐质量下降。

实际调用本接口时,请务必进行 接口测试 确保 Token 每次一致。

图片形式调用

one

本接口不推荐在自己的网站或 APP 中调用,只有您确实无法添加 JS 或 SDK 时才应该考虑调用。图片调用形式仅限在网站中调用。禁止在其他地方调用。

对于禁用了第三方 Cookies的浏览器(Chrome默认不禁用),本接口可能无法正常跟踪用户导致触发保护机制,降低推荐的效果。请悉知。

图片调用地址为:

https://v2.jinrishici.com/one.svg

Markdown 格式

![今日诗词](https://v2.jinrishici.com/one.svg)

HTML 格式

<img alt="今日诗词" src="https://v2.jinrishici.com/one.svg">

HTML 调用时在所在 DIV 居中并且不会 overflow :

<img alt="今日诗词" src="https://v2.jinrishici.com/one.svg" style="max-width:100%; display: block; margin: 0 auto;">

如果您需要自定义图片的文字的大小、间距、颜色,可以在图片地址后面加参数:

参数名 说明 默认值 合法范围
font-size 字体大小(px) 20 [8,50]
spacing 间距(px) 1.5 [0,30]
color 颜色 black 颜色英文单词

例如:

https://v2.jinrishici.com/one.svg?font-size=20&spacing=2&color=blue

需要注意的是,颜色目前只接收英文单词, 查看所有颜色英文单词

掘金等一些网站或论坛,会在后端保存图片并替换地址,请注意识别。

他们还出品了 https://gushi.ci/ ,号称调用速度更快,好像也没有…