今日诗词 API，根据时间、地点、天气、事件智能返回一句古诗词，支持图片和 JSON 返回，提供 SDK，一分钟添加到网站（原一言古诗词 API 升级版）

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

爱意满满的作品展示区。

这是一个创建于 2275 天前的主题，其中的信息可能已经有所发展或是发生改变。

今日诗词

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

调用文档： https://www.jinrishici.com/doc/

简介

今日诗词 API 是一个可以返回一句古诗词名句的接口。它可以通过图片和 JSON 格式调用。今日诗词 API 根据不同地点、时间、节日、季节、天气、景观、城市、事件进行智能推荐。

怎么调用

博客类的网站可以直接使用 sdk 调用

引入：

<script src="https://sdk.jinrishici.com/v2/browser/jinrishici.js" charset="utf-8"></script>

在需要添加的地方加一个 id="jinrishici-sentence"

比如：

<span id="jinrishici-sentence">正在加载今日诗词....</span>

另有回调函数，可以自行处理，详见文档

论坛文章可以调用图片

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

（ V2EX 回帖不支持这个）

另有小程序 SDK，详见文档

为什么要做这个接口

上次在 v2 公开的旧版本接口还挺多人使用的，所以花了点时间重做了这个古诗词接口。

在一些游戏中，根据游戏内不同的天气或日期，可以触发一系列“奇遇”或者“成就”，这个感觉非常过瘾。我的想法也是想打通虚拟与现实的界限，做一个没有人做过的诗词推荐产品。当然也感谢一些网友（见文档致谢）的建议。

关于产品

为了方便广大赖人站长朋友添加这个 API 到网站上，我在上一个版本就已经“独家”搞出基于 svg 的接口返回的形式，不过具体使用上可能还是稍微麻烦。现在我直接把 SDK 也写好，就可以像百度统计一样直接复制调用了。

我也想把影响力扩展到小程序上面，我们为小程序也提供了 SDK，并且我重新注册了一个 .com 域名并且备案（旧接口仍然提供服务，域名不变）。也请 v 友相信这个接口是想长久做的。

关于开发

上一个版本接口用的是 vert.x 开发，vert.x 引入了大量 js 风格，在中大型项目上面非常蛋疼，比如没有 POJO，全是 JsonObject。没有接口，只有类似反射的调用方法。没有 IOC，只能自己 new。还有可怕的回调地狱。

好在 Spring 给了 Java 异步开发者一些希望。Spring Webflux 经过一年多的迭代，已经达到基本能用的水平。尤其是配套的 Reactor 3 采用了类似 Rxjava 的链式操作（或者可以理解为 Stream 的异步加强版），大幅简化了并行开发，异步开发的难度，提高了可读性。目前 Spring Webflux 已经集成在 Spring Boot 2 中，无缝和 SpringMVC 使用方法对接，并且可以无缝享受到 Spring Boot 全家桶。本接口采用 Webflux 开发。

然而 Webflux 也继承了 Spring 家一贯臃肿的风格，性能比 Vert.x 差不少，不过好歹也是运行在 Netty 上，比同步开发的响应速度还是有质的提高。

写在后面

更多有关本产品的细节，我已经在文档中阐述。当然，在使用之前，你需要同意我们的使用协议。（不能使用在违法网站上等）。

最后，诚挚的感觉各位 v 友的支持。

诗词

spring

调用

推荐

116 条回复 • 2018-12-12 13:58:45 +08:00

1 2

❮

❯

LengthMin

2018-09-25 21:58:08 +08:00 via Android

很赞

paperseller

2018-09-25 22:34:53 +08:00 via iPhone

不知道做成 ios12 捷径可不可行

Tink

2018-09-25 22:44:30 +08:00 via iPhone

666,上捷径

lhx2008

2018-09-25 23:17:29 +08:00 via Android

@paperseller 没有玩过 ios，你可以试一下，不过不知道有没有地方存 token （或者 cookies ）

Sanko

2018-09-25 23:25:15 +08:00 via Android

一直在用旧版接口，支持

Tink

2018-09-25 23:27:41 +08:00 via iPhone

https://www.icloud.com/shortcuts/e7c9c6b8d29343a9928588323525ecf6

捷径 shortcuts

JamesSi

2018-09-25 23:29:34 +08:00 via Android

好东西要支持

Tink

2018-09-25 23:31:42 +08:00 via iPhone

@Tink #6 输出的是诗源，只要推荐诗句的话把那个 origin 删了就行

caijunyi

2018-09-26 00:15:35 +08:00

http://caijunyi.net/ 已经添加，哈哈，好东西

wb14123

2018-09-26 07:42:34 +08:00

赞！ Demo 里面能把整首诗输出就好了。

YingJie

2018-09-26 07:42:49 +08:00 via Android

旧版接口需要更换吗？

wb14123

2018-09-26 07:44:36 +08:00

但是测试了一下我在北京好像并没有和北京相关的诗句。

lhx2008

2018-09-26 07:57:28 +08:00 via Android

@wb14123 城市的诗句不多，不太好找。北京在唐宋也不是首都。

lhx2008

2018-09-26 07:58:03 +08:00 via Android

@YingJie 更换最好，也可以不换，旧版继续保留运营

why1

2018-09-26 08:06:20 +08:00 via Android

根据通讯录姓名返回一条怎样

NicholasYX

2018-09-26 08:33:04 +08:00 via iPhone

支持

lhx2008

2018-09-26 08:42:23 +08:00 via Android

@why1 哈哈，理论上应该也可以，不过现在感觉越来越少存通讯录了。

lhx2008

2018-09-26 08:43:38 +08:00 via Android

@wb14123 排版不太在行，现在就没输出原诗。不知道有没有 UI 或者前端的朋友帮忙搞一下哈哈

lhx2008

2018-09-26 08:43:52 +08:00 via Android

@caijunyi 谢谢支持

ZiLong

2018-09-26 09:33:36 +08:00

loethen

2018-09-26 09:57:25 +08:00

很棒已收藏

yangxiongguo

2018-09-26 10:07:44 +08:00

好玩，支持

paperseller

2018-09-26 10:14:18 +08:00 via iPhone

@wb14123 添加一个合并文本 action，分隔符为新行

whileFalse

2018-09-26 10:29:25 +08:00

虽然不知道有什么用，但是挺好玩的。

lhx2008

2018-09-26 10:46:54 +08:00 via Android

@whileFalse 可以加到博客最下面也不错

Edwards

2018-09-26 10:49:45 +08:00

战略性 mark

xi_lin

2018-09-26 11:15:21 +08:00

很棒，赞一个

azoon

2018-09-26 11:16:55 +08:00

不错不错，已经把楼主首页的功能直接搬走了。😝

xiyiailoli

2018-09-26 12:11:48 +08:00 via Android

mark，周末试试

paperseller

2018-09-26 12:14:37 +08:00 via iPhone

@Tink 在你的捷径基础上优化了下
一首诗词： https://www.icloud.com/shortcuts/3c7fa4e3c97e4465a8e1d3bc546607a1
一句诗词： https://www.icloud.com/shortcuts/9a15e2de64444e8ba6d7deac5791d707

mytry

2018-09-26 13:50:15 +08:00

当时我就念了两句诗 👓
https://i.loli.net/2018/09/26/5bab1ddaa05f0.png

aslanTT

2018-09-26 13:56:12 +08:00

小程序可以做成插件，直接集成

ww2000e

2018-09-26 14:23:25 +08:00

刷出来个菊花何太苦，遭此两重阳。。

lhx2008

2018-09-26 14:39:37 +08:00 via Android

@aslanTT 不知道能不能过审，插件要求比较多，sdk 其实就是帮你请求了个网络而已，我晚上试试。谢谢

LxRuzx

2018-09-26 15:04:22 +08:00

不错哦 mark 了

aslanTT

2018-09-26 15:18:16 +08:00

@lhx2008 这个过审问题不大，没有涉及到特殊分类，也没有涉及到社交、交易，就是个工具属性的。

lhx2008

2018-09-26 18:25:23 +08:00

@aslanTT 看了一下，自己没有搞公司的号，个人号还没法弄。

097ecom

2018-09-26 22:29:00 +08:00

mark 很好玩的样子

097ecom

2018-09-26 22:30:05 +08:00

楼主也是米农吧哈哈

lhx2008

2018-09-26 22:36:18 +08:00

@097ecom 不敢不敢，就持有了十几个米这样子，哈哈

techv

2018-09-27 16:48:09 +08:00

不错，已添加： https://imgless.com/

sagaxu

2018-09-27 16:58:54 +08:00 via Android

vertx 可以跟 springboot 一起用，spring 负责配置解析和 ioc，vertx 处理请求。pojo 可以用 mapFrom/mapTo。回调可以用 Future 解决，此外 vertx 也支持 rxjava，甚至连 Kotlin 的 coroutine 也无缝支持了。

vertx 是一站式异步解决方案，webflux 的 clientside 目前基本空白。

EmpCold

2018-09-27 17:35:16 +08:00

很少回复，正准备用一下。厉害了

lhx2008

2018-09-27 18:16:08 +08:00 via Android

@sagaxu
感谢回复
1.和 springboot 用可以的，不过用起来总是感觉怪怪的，webflux 直接免配置提供 springmvc 那一套，包括函数注解，参数注解，viewmodel，参数校验
2.json 这个，vet.x 自带的很弱，map 功能好像也没有，并且还不太兼容其他的 json 包 /普通对象，比如发上 eventbus 要写一个编解码器 return 一下自己，如果是用 vert.x service 就必须只能传自己的 jsonObject，这个很蛋疼
3. 回调这个确实不是大问题，不过自带的确实也很弱，主要是 eventbus 和 blokingpool 这个回调机制如果不利用的话，其实和 webflux 差不多（都是 netty 搞一层）
4. webflux client 有的，功能不比 vert.x 少，也是异步链式使用的，数据库客户端也有 mongo redis cassandra
https://docs.spring.io/spring/docs/current/spring-framework-reference/web-reactive.html#webflux-client

sagaxu

2018-09-27 18:38:17 +08:00 via Android

@lhx2008 小项目不建议使用 eventbus，自带的 cluster 也可以不用，走 grpc 或者其它协议也很方便。

vertx 内置支持 rxjava 的 api，rxjava 在响应式这一块儿比谁弱呢？

webflux 作为 client 支持的协议还是太少，比如你贴的文档里，只有 webclient 一种。

lhx2008

2018-09-27 19:12:26 +08:00 via Android

@sagaxu 如果是微服务那些框架，应该是搞到 spring cloud 里面有一套解决方案

其他协议确实是不支持了

saozhu

2018-09-27 20:32:35 +08:00 via iPhone

今天什么日子怎么全都带菊字的

lhx2008

2018-09-27 22:36:25 +08:00

@saozhu 可以看 https://www.jinrishici.com/doc/#how 的表，花类主要是补充一下诗词不够的情况。。

lhx2008

2018-09-27 22:38:21 +08:00

@lhx2008 哦，不，我看了一下，可能只是古诗写菊花的比较多吧。。菊花的事件转化规则还没写

zhuliuqi

2018-09-28 07:23:25 +08:00

有意思 mark

tyhtao1990

2018-09-28 09:16:02 +08:00

赞，楼主可以的

TimLang

2018-09-29 10:58:10 +08:00

@lhx2008 挂 adsense 广告的网站能免费试用吗

lhx2008

2018-09-29 11:03:27 +08:00 via Android

@TimLang 可以，只是说整个网页是以我的推荐为主要内容的不行

hanbing135

2018-09-29 18:11:50 +08:00 via Android

建议出个微信小程序

lhx2008

2018-09-29 18:13:11 +08:00 via Android

@hanbing135 本来是有这个计划的，但是迫于 UI 太丑搁置了，而且没得参考。。

moxiaonai

2018-09-29 18:55:55 +08:00

mark

moxiaonai

2018-09-29 18:59:41 +08:00

文档太丑，推荐 https://github.com/docsifyjs/docsify 优化一下

lhx2008

2018-09-29 19:14:02 +08:00

@moxiaonai emm，还好吧？比较简洁明了，字大小也比较合适。除了没有代码高亮。acsiidoc 写的，spring 文档同款

dakb

2018-09-29 19:22:15 +08:00

刚好需要。tks

StevenZhang

2018-09-30 10:12:54 +08:00

支持

amwyyyy

2018-09-30 16:14:41 +08:00

不错，我拿来做终端启动的欢迎语了

LWXYFER

2018-10-01 17:28:04 +08:00

支持

zealzz

2018-10-02 11:43:12 +08:00 via Android

可以试着把名人名言也放进去，这样内容应该会更丰富。

testsec

2018-10-03 04:10:44 +08:00 via iPhone

如果有作者就更好了

lhx2008

2018-10-03 08:11:45 +08:00 via Android

@testsec json 接口啥都有，翻译都有

ddzzhen

2018-10-08 09:32:43 +08:00

有想法的人

chendeshen

2018-10-08 09:41:41 +08:00

真的赞，真想看其 Spring 源码

liangzi

2018-10-08 09:45:01 +08:00 via Android

回头试试

sunnybird

2018-10-08 21:03:45 +08:00

赞，mark

tonghuazhen

2018-10-09 09:15:14 +08:00

https://blog.extrastu.xin 已加上,很赞

Nobitasean

2018-10-09 10:29:21 +08:00

更倾向于壁纸 api

SCaffrey

2018-10-09 11:45:56 +08:00 via Android

赞~

另：广大赖人站长哈哈哈

liangzi

2018-10-10 17:09:31 +08:00 via Android

hexo 第二步，在你需要放置诗词的地方，添加一个 id 属性，id 名为 jinrishici-sentence 这个到底放哪儿？

lhx2008

2018-10-10 17:15:37 +08:00

@liangzi 放在哪就在哪里显示，比如把下面的两行放到一个空的 html 里面，打开浏览器就可以看到效果

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

liangzi

2018-10-10 17:17:24 +08:00 via Android

@lhx2008 回去试试谢谢

dyxang

2018-10-11 22:57:42 +08:00 via Android

楼主可以试试这个百度诗词标签的思路
在手机上是这种效果
http://clients3.google.com/generate_204

dyxang

2018-10-11 22:58:11 +08:00 via Android

啊不发错了，是这个

dyxang

2018-10-11 23:05:10 +08:00 via Android

要是有程序和这个配合让诗词显示在电脑桌面就好了……

lhx2008

2018-10-11 23:23:10 +08:00 via Android

@dyxang 我采用了这个的部分数据，但是情感，动植物标签这种太泛化了。

显示在桌面也不错，应该十几二十行代码就可以了，不过我对桌面开发不太熟悉

linKnowEasy

2018-10-12 09:42:00 +08:00

用楼主的 API, 写了一个 Mac 菜单栏。自己看

dyxang

2018-10-12 11:51:06 +08:00 via Android

@linKnowEasy windows 不行吗……😖

linKnowEasy

2018-10-12 12:03:03 +08:00

@dyxang windows 可以试试 C # 或者跨平台. 应该也简单的
主要 Mac 在顶部,方便看。windows 的菜单栏在底部.

dyxang

2018-10-12 12:24:49 +08:00 via Android

@linKnowEasy 简单但是我不会😣。放弃了😂

corerzhang

2018-10-15 14:46:39 +08:00

请教下楼主，如果是在移动端 App 的调用 JSON-TOKEN 接口，这个接口只需要在 headers 带上 token 参数，那么是如果确定用户的位置的？

lhx2008

2018-10-15 14:52:00 +08:00 via Android

@corerzhang IP 地址都在 TCP 头上面，因为 JSON-TOKEN 也是用户端调用，所以用户向我们的 HTTP 请求会附带 IP 信息

liuooooo

2018-10-17 10:12:24 +08:00

z0ne

2018-10-17 12:17:51 +08:00

很棒！

上边很多朋友对 iOS 捷径很感兴趣啊！也有大牛做了出来，我正好有点时间，就把上边大牛做的捷径进行了修改优化+功能扩展，支持复制、分享等操作。

小程序中搜索 ShortCuts 就可以看到捷径下载啦！
或者扫一扫小程序码立即安装：

![](

)

imhx233

2018-10-17 17:04:24 +08:00 via iPhone

@livid 这人开了帖子推广他的 Shortcuts 小程序然后在这里无意义回帖感觉 spam

z0ne

2018-10-17 18:54:20 +08:00

@imhx233 不好意思给你带来了你觉得不舒服的感觉。

但是我要反驳一下，关于这个“无意义回帖”，我不太懂你指的无意义是什么？我是否可以理解为你这个回复和主题无关，也属于无意义的回帖？

我是看到上边大佬做出了 iOS 的捷径，而正好，我正在做这一块，然后下载安装体验了下，有很多可以改进优化扩展的地方，于是我直接进行了修改发布然后在这里分享，试问这个从何判断与主题无关呢？

顺便，除了 @站长，你也可以直接 @我的，不然感觉像回到了学生时代，隔壁桌男生举手报告老师说我在看课外读物似的。

语气有点冲，望谅解

z0ne

2018-10-17 18:57:10 +08:00

@z0ne
不然感觉像回到了学生时代，隔壁桌戴着眼镜的男生一脸愤怒地举起了手，“英语老师！他在你的课上看计算机的书！我建议你应该罚他出去站一个小时！”

哈哈~ 开玩笑，冷笑话 🙂

sobigfish

2018-10-19 10:27:10 +08:00

建议可以加 query，省去某些关键词的推荐么，比如地区全是一个地区的诗看着也累或者本来下雨或者很冷再来关于雨的也很心伤😂
https://v2.jinrishici.com/one.json?DonotMatchTags=area|weather 这么来

lhx2008

2018-10-19 10:43:35 +08:00

@sobigfish

首先说一下推荐方面的。推荐比较单调，比如一般一个人也只有 10 个标签，也就是推这 10 个标签的诗，这个问题存在，但是不太好解决，我目前也没想到什么办法。至于负效果的标签，可以考虑推荐一些正能量的诗？哈哈。

第二个是你提的这个，我的想法是不加，因为我这个主要还是站长放到他网站上面，所以是我的接口直接面向的是每一个不同的实际用户，我不想站长替用户做推荐的决定（比如，增加一些附加参数，可能导致推荐效果更差，这是站长难以预料的）。当然我这个产品也必须符合大多数的人的需求才行。

yinqi025

2018-10-20 09:37:00 +08:00

蛮有趣的东西,已收藏

Mystery0

2018-10-20 11:45:23 +08:00 via Android

挺有用的，暫時收藏一個，後面看看能不能加到 app 裡面（不盈利的 app 啦）

lhx2008

2018-10-20 12:10:00 +08:00 via Android

@Mystery0 谢谢，以自己的内容盈利的话没有关系的，我只是不想有人直接拿我的接口去赚钱

lusi1990

2018-10-20 15:07:07 +08:00

很不错，收藏

PulpFunction

2018-10-20 20:30:10 +08:00

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

PulpFunction

2018-10-20 20:30:24 +08:00

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

PulpFunction

2018-10-20 20:31:54 +08:00

看不出来啊大佬还是文艺的雅痞

100

agonyperkey

2018-10-23 08:40:30 +08:00

我觉得，二十四节气，也可以整合一下标签😁😁😁

1 2

❮

❯

今日诗词 API，根据时间、地点、天气、事件智能返回一句古诗词，支持图片和 JSON 返回，提供 SDK，一分钟添加到网站（原一言古诗词 API 升级版）

简介

怎么调用

博客类的网站可以直接使用 sdk 调用

论坛文章可以调用图片

为什么要做这个接口

推荐怎么做的

关于产品

关于开发

写在后面