今日诗词 API，根据时间、地点、天气、事件智能返回一句古诗词，支持图片和 JSON 返回，提供 SDK，一分钟添加到网站（原一言古诗词 API 升级版）
lhx2008 · xenv · 2018-09-25 21:42:08 +08:00 · 18913 次点击这是一个创建于 2249 天前的主题，其中的信息可能已经有所发展或是发生改变。
官网： 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>
另有回调函数，可以自行处理，详见 文档
论坛文章可以调用图片
（ V2EX 回帖不支持这个）
另有小程序 SDK，详见 文档
为什么要做这个接口
上次在 v2 公开的 旧版本接口 还挺多人使用的，所以花了点时间重做了这个古诗词接口。
在一些游戏中，根据游戏内不同的天气或日期，可以触发一系列“奇遇”或者“成就”，这个感觉非常过瘾。我的想法也是想打通虚拟与现实的界限，做一个没有人做过的诗词推荐产品。当然也感谢一些网友（见 文档 致谢）的建议。
推荐怎么做的
在推荐方面，主要是能根据真实世界的环境做出诗词推荐。这个和传统的推荐系统不同，并不是基于历史数据集推荐的的形式，而主要是利用时间地点上下文信息，把时间地点天气信息转化为事件，根据事件标签进行相关推荐。这个领域我目前还没有看到有相关的产品，所以也是摸石头过河的状态。在评估诗词好坏，推荐契合度的时候，也引入了一些指标，但是具体效果仍待评估。
当然这也可能是一个恶性循环，因为我们没有办法收集用户的喜好，所以可能永远没有办法做到根据个人喜好推荐。当然，也有考虑商用版本，可以基于注册用户的推荐。
这个产品只有我一个人完成，所以无论是推荐事件制定还是诗词源标注上，都是以我自己的经验制定和打标，难免有偏颇之处，不过广大 v 友也可以提提意见，看看如何不断改进这个系统。十分感谢。
详细的推荐思路和推荐标签： https://www.jinrishici.com/doc/#how
关于产品
为了方便广大赖人站长朋友添加这个 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 友的支持。
 |
1
LengthMin 2018-09-25 21:58:08 +08:00 via Android
很赞
|
 |
2
paperseller 2018-09-25 22:34:53 +08:00 via iPhone  2
不知道做成 ios12 捷径可不可行
|
 |
3
Tink 2018-09-25 22:44:30 +08:00 via iPhone
666,上捷径
|
 |
4
lhx2008 OP @paperseller 没有玩过 ios，你可以试一下，不过不知道有没有地方存 token （或者 cookies ）
|
 |
5
Sanko 2018-09-25 23:25:15 +08:00 via Android
一直在用旧版接口，支持
|
|
6
Tink 2018-09-25 23:27:41 +08:00 via iPhone 1
|
 |
7
JamesSi 2018-09-25 23:29:34 +08:00 via Android
好东西要支持
|
 |
9
caijunyi 2018-09-26 00:15:35 +08:00
http://caijunyi.net/ 已经添加，哈哈，好东西
|
 |
10
wb14123 2018-09-26 07:42:34 +08:00
赞！ Demo 里面能把整首诗输出就好了。
|
 |
11
YingJie 2018-09-26 07:42:49 +08:00 via Android
旧版接口需要更换吗？
|
|
12
wb14123 2018-09-26 07:44:36 +08:00
但是测试了一下我在北京好像并没有和北京相关的诗句。
|
 |
15
why1 2018-09-26 08:06:20 +08:00 via Android
根据通讯录姓名返回一条怎样
|
 |
16
NicholasYX 2018-09-26 08:33:04 +08:00 via iPhone
支持
|
|
18
lhx2008 OP @wb14123 排版不太在行，现在就没输出原诗。不知道有没有 UI 或者前端的朋友帮忙搞一下 哈哈
|
 |
20
ZiLong 2018-09-26 09:33:36 +08:00
赞
|
 |
21
loethen 2018-09-26 09:57:25 +08:00
很棒 已收藏
|
 |
22
yangxiongguo 2018-09-26 10:07:44 +08:00
好玩，支持
|
|
23
paperseller 2018-09-26 10:14:18 +08:00 via iPhone
@wb14123 添加一个合并文本 action，分隔符为新行
|
 |
24
whileFalse 2018-09-26 10:29:25 +08:00
虽然不知道有什么用，但是挺好玩的。
|
|
25
lhx2008 OP @whileFalse 可以加到博客最下面也不错
|
 |
26
Edwards 2018-09-26 10:49:45 +08:00
战略性 mark
|
 |
27
xi_lin 2018-09-26 11:15:21 +08:00
很棒，赞一个
|
 |
28
azoon 2018-09-26 11:16:55 +08:00
不错不错，已经把楼主首页的功能直接搬走了。😝
|
 |
29
xiyiailoli 2018-09-26 12:11:48 +08:00 via Android
mark，周末试试
|
|
30
paperseller 2018-09-26 12:14:37 +08:00 via iPhone 2
|
 |
31
mytry 2018-09-26 13:50:15 +08:00 1
|
 |
32
aslanTT 2018-09-26 13:56:12 +08:00
小程序可以做成插件，直接集成
|
 |
33
ww2000e 2018-09-26 14:23:25 +08:00 2
刷出来个 菊花何太苦，遭此两重阳 。。
|
|
34
lhx2008 OP @aslanTT 不知道能不能过审，插件要求比较多，sdk 其实就是帮你请求了个网络而已，我晚上试试。谢谢
|
 |
35
LxRuzx 2018-09-26 15:04:22 +08:00
不错哦 mark 了
|
 |
38
097ecom 2018-09-26 22:29:00 +08:00
mark 很好玩的样子
|
|
39
097ecom 2018-09-26 22:30:05 +08:00
楼主也是米农吧哈哈
|
 |
41
techv 2018-09-27 16:48:09 +08:00
不错，已添加： https://imgless.com/
|
 |
42
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 目前基本空白。 |
 |
43
EmpCold 2018-09-27 17:35:16 +08:00
很少回复，正准备用一下。厉害了
|
|
44
lhx2008 OP @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 |
|
45
sagaxu 2018-09-27 18:38:17 +08:00 via Android
@lhx2008 小项目不建议使用 eventbus，自带的 cluster 也可以不用，走 grpc 或者其它协议也很方便。
vertx 内置支持 rxjava 的 api，rxjava 在响应式这一块儿比谁弱呢？ webflux 作为 client 支持的协议还是太少，比如你贴的文档里，只有 webclient 一种。 |
|
46
lhx2008 OP |
 |
47
saozhu 2018-09-27 20:32:35 +08:00 via iPhone
今天什么日子 怎么全都带菊字的
|
|
48
lhx2008 OP @saozhu 可以看 https://www.jinrishici.com/doc/#how 的表，花类主要是补充一下诗词不够的情况。。
|
 |
50
zhuliuqi 2018-09-28 07:23:25 +08:00
有意思 mark
|
 |
51
tyhtao1990 2018-09-28 09:16:02 +08:00
赞，楼主可以的
|
 |
54
hanbing135 2018-09-29 18:11:50 +08:00 via Android
建议出个微信小程序
|
|
55
lhx2008 OP @hanbing135 本来是有这个计划的，但是迫于 UI 太丑搁置了，而且没得参考。。
|
 |
56
moxiaonai 2018-09-29 18:55:55 +08:00
mark
|
|
57
moxiaonai 2018-09-29 18:59:41 +08:00
文档太丑，推荐 https://github.com/docsifyjs/docsify 优化一下
|
|
58
lhx2008 OP @moxiaonai emm，还好吧？比较简洁明了，字大小也比较合适。除了没有代码高亮。acsiidoc 写的，spring 文档同款
|
 |
59
dakb 2018-09-29 19:22:15 +08:00
刚好需要。tks
|
 |
60
StevenZhang 2018-09-30 10:12:54 +08:00
支持
|
 |
61
amwyyyy 2018-09-30 16:14:41 +08:00
不错，我拿来做终端启动的欢迎语了
|
 |
62
LWXYFER 2018-10-01 17:28:04 +08:00
支持
|
 |
63
zealzz 2018-10-02 11:43:12 +08:00 via Android
可以试着把名人名言也放进去，这样内容应该会更丰富。
|
 |
64
testsec 2018-10-03 04:10:44 +08:00 via iPhone
如果有作者就更好了
|
 |
66
ddzzhen 2018-10-08 09:32:43 +08:00
有想法的人
|
 |
67
chendeshen 2018-10-08 09:41:41 +08:00
真的赞，真想看其 Spring 源码
|
 |
68
liangzi 2018-10-08 09:45:01 +08:00 via Android
回头试试
|
 |
69
sunnybird 2018-10-08 21:03:45 +08:00
赞，mark
|
 |
70
tonghuazhen 2018-10-09 09:15:14 +08:00
https://blog.extrastu.xin 已加上,很赞
|
 |
71
Nobitasean 2018-10-09 10:29:21 +08:00
更倾向于壁纸 api
|
 |
72
SCaffrey 2018-10-09 11:45:56 +08:00 via Android
赞~
另：广大赖人站长 哈哈哈 |
|
73
liangzi 2018-10-10 17:09:31 +08:00 via Android
hexo 第二步，在你需要放置诗词的地方，添加一个 id 属性，id 名为 jinrishici-sentence 这个到底放哪儿？
|
|
74
lhx2008 OP @liangzi 放在哪就在哪里显示，比如把下面的两行放到一个空的 html 里面，打开浏览器就可以看到效果
<span id="jinrishici-sentence">正在加载今日诗词....</span> <script src="https://sdk.jinrishici.com/v2/browser/jinrishici.js" charset="utf-8"></script> |
 |
76
dyxang 2018-10-11 22:57:42 +08:00 via Android
|
|
77
dyxang 2018-10-11 22:58:11 +08:00 via Android
啊不发错了，是这个
 |
|
78
dyxang 2018-10-11 23:05:10 +08:00 via Android
要是有程序和这个配合让诗词显示在电脑桌面就好了……
|
|
79
lhx2008 OP |
 |
80
linKnowEasy 2018-10-12 09:42:00 +08:00
用楼主的 API, 写了一个 Mac 菜单栏。自己看
 |
|
81
dyxang 2018-10-12 11:51:06 +08:00 via Android
@linKnowEasy windows 不行吗……😖
|
|
82
linKnowEasy 2018-10-12 12:03:03 +08:00
@dyxang windows 可以试试 C # 或者跨平台. 应该也简单的
主要 Mac 在顶部,方便看。windows 的菜单栏在底部. |
|
83
dyxang 2018-10-12 12:24:49 +08:00 via Android
@linKnowEasy 简单但是我不会😣。放弃了😂
|
 |
84
corerzhang 2018-10-15 14:46:39 +08:00
请教下楼主，如果是在移动端 App 的调用 JSON-TOKEN 接口，这个接口只需要在 headers 带上 token 参数，那么是如果确定用户的位置的？
|
|
85
lhx2008 OP @corerzhang IP 地址都在 TCP 头上面，因为 JSON-TOKEN 也是用户端调用，所以用户向我们的 HTTP 请求会附带 IP 信息
|
 |
86
liuooooo 2018-10-17 10:12:24 +08:00
赞
|
 |
87
z0ne 2018-10-17 12:17:51 +08:00
很棒！
上边很多朋友对 iOS 捷径很感兴趣啊！也有大牛做了出来，我正好有点时间，就把上边大牛做的捷径进行了修改优化+功能扩展，支持复制、分享等操作。 小程序中搜索 ShortCuts 就可以看到捷径下载啦！ 或者扫一扫小程序码立即安装：  ) |
|
89
z0ne 2018-10-17 18:54:20 +08:00
@imhx233 不好意思给你带来了你觉得不舒服的感觉。
但是我要反驳一下，关于这个“无意义回帖”，我不太懂你指的无意义是什么？我是否可以理解为你这个回复和主题无关，也属于无意义的回帖？ 我是看到上边大佬做出了 iOS 的捷径，而正好，我正在做这一块，然后下载安装体验了下，有很多可以改进优化扩展的地方，于是我直接进行了修改发布然后在这里分享，试问这个从何判断与主题无关呢？ 顺便，除了 @站长，你也可以直接 @我的，不然感觉像回到了学生时代，隔壁桌男生举手报告老师说我在看课外读物似的。 语气有点冲，望谅解 |
|
90
z0ne 2018-10-17 18:57:10 +08:00
|
 |
91
sobigfish 2018-10-19 10:27:10 +08:00
建议可以加 query，省去某些关键词的推荐么，比如地区 全是一个地区的诗 看着也累 或者本来下雨或者很冷 再来关于雨的也很心伤😂
https://v2.jinrishici.com/one.json?DonotMatchTags=area|weather 这么来 |
|
92
lhx2008 OP @sobigfish
首先说一下推荐方面的。推荐比较单调，比如一般一个人也只有 10 个标签，也就是推这 10 个标签的诗，这个问题存在，但是不太好解决，我目前也没想到什么办法。至于负效果的标签，可以考虑推荐一些正能量的诗？哈哈。 第二个是你提的这个，我的想法是不加，因为我这个主要还是站长放到他网站上面，所以是我的接口直接面向的是每一个不同的实际用户，我不想站长替用户做推荐的决定（比如，增加一些附加参数，可能导致推荐效果更差，这是站长难以预料的）。当然我这个产品也必须符合大多数的人的需求才行。 |
 |
93
yinqi025 2018-10-20 09:37:00 +08:00
蛮有趣的东西,已收藏
|
 |
94
Mystery0 2018-10-20 11:45:23 +08:00 via Android
挺有用的，暫時收藏一個，後面看看能不能加到 app 裡面（不盈利的 app 啦）
|
 |
96
lusi1990 2018-10-20 15:07:07 +08:00
很不错 ，收藏
|
 |
97
PulpFunction 2018-10-20 20:30:10 +08:00
|
|
98
PulpFunction 2018-10-20 20:30:24 +08:00
|
|
99
PulpFunction 2018-10-20 20:31:54 +08:00
看不出来啊 大佬还是文艺的雅痞
|
 |
100
agonyperkey 2018-10-23 08:40:30 +08:00
我觉得，二十四节气，也可以整合一下标签😁😁😁
|
Select Language