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

简介

今日诗词 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 友的支持。