官网: https://www.jinrishici.com/
调用文档: https://www.jinrishici.com/doc/
今日诗词 API 是一个可以返回一句古诗词名句的接口。它可以通过图片和 JSON 格式调用。今日诗词 API 根据不同地点、时间、节日、季节、天气、景观、城市、事件进行智能推荐。
引入:
<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 公开的 旧版本接口 还挺多人使用的,所以花了点时间重做了这个古诗词接口。
在一些游戏中,根据游戏内不同的天气或日期,可以触发一系列“奇遇”或者“成就”,这个感觉非常过瘾。我的想法也是想打通虚拟与现实的界限,做一个没有人做过的诗词推荐产品。当然也感谢一些网友(见 文档 致谢)的建议。
在推荐方面,主要是能根据真实世界的环境做出诗词推荐。这个和传统的推荐系统不同,并不是基于历史数据集推荐的的形式,而主要是利用时间地点上下文信息,把时间地点天气信息转化为事件,根据事件标签进行相关推荐。这个领域我目前还没有看到有相关的产品,所以也是摸石头过河的状态。在评估诗词好坏,推荐契合度的时候,也引入了一些指标,但是具体效果仍待评估。
当然这也可能是一个恶性循环,因为我们没有办法收集用户的喜好,所以可能永远没有办法做到根据个人喜好推荐。当然,也有考虑商用版本,可以基于注册用户的推荐。
这个产品只有我一个人完成,所以无论是推荐事件制定还是诗词源标注上,都是以我自己的经验制定和打标,难免有偏颇之处,不过广大 v 友也可以提提意见,看看如何不断改进这个系统。十分感谢。
详细的推荐思路和推荐标签: https://www.jinrishici.com/doc/#how
为了方便广大赖人站长朋友添加这个 API 到网站上,我在上一个版本就已经“独家”搞出基于 svg 的接口返回的形式,不过具体使用上可能还是稍微麻烦。现在我直接把 SDK 也写好,就可以像百度统计一样直接复制调用了。
我也想把影响力扩展到小程序上面,我们为小程序也提供了 SDK,并且我重新注册了一个 .com 域名并且备案(旧接口仍然提供服务,域名不变)。也请 v 友相信这个接口是想长久做的。
好在 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
![今日诗词]( ‘ https://v2.jinrishici.com/one.svg ’)
|
98
PulpFunction 2018-10-20 20:30:24 +08:00
![今日诗词]( 'https://v2.jinrishici.com/one.svg')
|
99
PulpFunction 2018-10-20 20:31:54 +08:00
看不出来啊 大佬还是文艺的雅痞
|
100
agonyperkey 2018-10-23 08:40:30 +08:00
我觉得,二十四节气,也可以整合一下标签😁😁😁
|