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

网站快速安装

为了方便大家的调用，今日诗词特意开发了一款 JS-SDK 供大家快速部署。这款SDK帮你完成了 高级 JSON 接口 的所有步骤。

1. 通用简单安装代码

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

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

Tips:

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

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

2. 通用高级安装代码

如果你有其他需求（如获取作者、朝代等），可以调用该网提供的加载函数 jinrishici.load 并传入回调函数，每调用一次，会传入一个新的诗词。

Tips：

①result 的 格式见 接口返回结果格式

②出错该接口会帮你打在控制台上，你无需再次处理

③使用定制加载时，不要将标签的 id 或者 class 设置为 jinrishici-sentence ，否则SDK会自动加载一次

④使用 load 之前，请确保 SDK JS 文件已经引入

3.博客/论坛简单安装示例

本示例适用于 WordPress / Typecho / Emlog / Hexo / Hugo 等博客和 Discuz / PHPwind / Xiuno 等论坛。

您想添加一句诗词到您的网站，您需要找到您选择使用的模板的相应位置。加入快速安装代码即可。

如果您找不到，可以使用文本搜索附近的 HTML 代码关键字。

比如，您想添加到页脚，一般您需要修改 footer.php，加入安装代码即可。

需要注意的是，不要把安装代码粘贴到 <?php 和 ?> 中间。

<footer id="footer" role="contentinfo">

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

    &copy; <?php echo date('Y'); ?> <a href="<?php $this->options->siteUrl(); ?>"><?php $this->options->title(); ?></a>.
    <?php _e('由 <a href="http://www.typecho.org">Typecho</a> 强力驱动'); ?>.
</footer><!-- end #footer -->

Tips：可能有一些同学受其他 hitokoto 一言 API 的影响，认为可以直接在服务器用 PHP 的 curl 等方法直接请求接口，这在本接口是 完全错误 的。

内容源自今日诗词 – 一言API，小轻论坛整理发布。更多内容请详见该网站接口介绍。