每日诗词 API 是一个可以返回一句古诗词名句的接口。每日诗词 API 根据不同地点、时间、节日、季节、天气、景观、城市进行智能推荐。

如果您不以我们的接口及其提供的内容盈利,您可以免费的使用我们的 API。使用我们的 API 代表您同意了我们的 使用协议

1. 支持哪种网站安装方式?

为了提高推荐的效果,请您选择合适的安装方法。
原则上,为了获取到正确的 IP 定位信息,我们的接口都不应在服务端调用。

2. 网站快速安装

浏览器能直接打开的网站才能使用本方法部署

2.1. 通用简单安装代码

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

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

SDK 会自动寻找 id 或者 classmeirishici-sentence 的标签,将里面的内容替换为诗词
如果需要在多个地方显示诗词,添加多个 class=" meirishici-sentence " 的 span 即可

2.2. 通用高级安装代码

如果你有其他需求(如获取作者、朝代等),可以调用我们提供的加载函数 meirishici.load 并传入回调函数,每调用一次,会传入一个新的诗词

<script src="https://sdk.meirishici.top/v2/browser/meirishici.js" charset="utf-8"></script>
<script type="text/javascript">
  meirishici.load(function(result) {
    // 自己的处理逻辑
    console.log(result)
  });
</script>
result 的 格式见 接口返回结果格式
出错我们会帮你打在控制台上,您无需再次处理。
使用定制加载时,不要将标签的 id 或者 class 设置为 meirishici-sentence ,否则SDK会自动加载一次
使用 load 之前,请确保 SDK JS 文件已经引入

一个高级版的使用例子,可以复制到一个 HTML 文件用浏览器打开查看效果:

<script src="https://sdk.meirishici.top/v2/browser/meirishici.js" charset="utf-8"></script>
<div id="poem_sentence"></div>
<div id="poem_info"></div>
<script type="text/javascript">
  meirishici.load(function(result) {
    var sentence = document.querySelector("#poem_sentence")
    var info = document.querySelector("#poem_info")
    sentence.innerHTML = result.data.content
    info.innerHTML = '【' + result.data.origin.dynasty + '】' + result.data.origin.author + '《' + result.data.origin.title + '》'
  });
</script>

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

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

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

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

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

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

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

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

    &copy; <?php echo date('Y'); ?> <a href="<?php $this->options->siteUrl(); ?>"><?php $this->options->title(); ?></a>.
</footer><!-- end #footer -->

3. 使用协议

使用本API接口代表您 已经同意 以下的使用协议:

一、 使用本接口,您的网站和您的行为必须满足以下条件:

  1. 内容和您的行为符合中国大陆法律

  2. 不恶意访问、攻击本接口

  3. 不使用自动化工具有目的地抓取保存本接口的数据

  4. 不伪造、仿冒、反向代理本接口

二、 满足以下条件,您可以 免费使用 本接口

  1. 不以本接口及其提供的内容盈利 ,盈利行为包括但不仅限于:出售本接口信息、在以本接口为主体内容的页面中放置广告 等。但如果在有自己内容的页面调用本接口不受该限制。

本接口不开放商用

三、 本接口保留以下权利

  • 对于异常访问的用户,接口在一定时间内 降低推荐质量 的权利,异常行为包括:

    • 短时间内大量访问

  • 对于以下行为,接口 拒绝服务 的权利:

    • 违法网站调用

    • 短时间内巨量访问,目前规则为: 5秒内单IP只能访问25次,超过的部分返回 403

  • 自行更改协议的权利。

四、免责声明

  1. 本接口提供的诗词数据来源于网络,如有侵权或错漏,请联系我们删除。

  2. 本接口推荐结果是根据时间、地点、天气等数据使用机器自动推荐,不代表本接口及其所有者赞成键入内容及推荐结果的内容或立场。

  3. 本接口为开放调用,不代表本接口及其所有者赞成调用本接口的终端上的内容或立场。

  4. 我们尽最大可能保证接口的稳定性,但对于本接口,我们不做任何稳定性、可靠性保证,由于本接口无法访问而带来的损失,本接口以及所有者不对此负责。

五、隐私权声明

  1. 本接口会临时获取用户公开的 IP 数据用以推荐,会向用户电脑置入 CookiesToken 信息记录历史推荐数据,如果您的终端用户认为此行为侵犯了他们的隐私,您应对此负责。

4. 常见问题

4.1. 接口调用量有什么限制?

如果按照文档正确配置接口,调用原则上无限制。但要注意,短时间内大量调用,会导致诗词推荐质量下降。

4.2. 项目是否开源?

本项目暂不开源,原因是推荐具有高度定制性,可重用性比较差,开源无益。

4.3. 接口稳定吗?

我们尽最大可能维持接口的稳定性,长效性。

技术上,我们使用 Spring-Boot, Spring-WebFlux 开发,运行在 Netty 上,使用了 Mongo 数据库和 Redis 缓存,具有一定健壮性。

但对于恶意攻击和不可抗力因素导致的接口访问异常,我们只能尽快修复。

4.4. 我们是如何推荐的?

  1. 根据调用的用户所在地,收集真实世界的信息,包括天气、时间、日期、事件等等

  2. 把真实世界信息转化为标签和其他特征,按特征拉取初步推荐池 推荐关联的标签有哪些?

  3. 去掉已经推荐过给该用户的诗词

  4. 判断诗词的好坏,并且根据一列算法对推荐池的诗词进行打分排序

  5. 根据真实世界的不同情况,选择不同的策略进行分段抽取,并缓存

  6. 从缓存池逐条返回

4.5. 推荐关联的标签有哪些?

注:该表仅供参考,和实际接口有出入。

标签
触发条件
气象触发标签
天气晴
天气雨
小雨
天气小雨/ 降水量
大雨
天气大雨/ 降水量
天气阴
天气多云
风力 >=2级
无风
风力 <= 1级
东风
东风,风力 >=2级
南风
南风,风力 >=2级
西风
西风,风力 >=2级
北风
北风,风力 >=2级
微风
风力 [2,3] 级
大风
风力 >= 4级
天气雪
雷电
雷电天气
干旱
沙尘
能见度
寒冷
气温 <= 10 度
炎热
气温 >= 30 度
时间触发标签
日出
当地日出时间后1小时
日落
当地日落前后1小时
正午
北京时间11-13点(人们通常认为12点为正午)
上午
[8-11]点
下午
[13-17]点
晚上
日落后1小时 - 晚上12点
凌晨
[0-5]点
日期触发标签
农历2-4月
农历5-7月
农历8-10月
农历10-1月
除夕
除夕
春节
春节
新年
元旦,春节
元宵
元宵
寒食
寒食
清明
清明
端午
端午
七夕
七夕
爱情
七夕, 元宵, 情人节,白色情人节
中秋
中秋
重阳
重阳
劳动
劳动节
爱国
国庆节,七七,九一八
妇女
妇女节
母亲
母亲节
父亲
父亲节
儿童
儿童节
老师
教师节
地理标签
华东
山东、江苏、安徽、浙江、福建、上海
华南
广东、广西、海南
华中
湖北、湖南、河南、江西
华北
北京、天津、河北、山西、内蒙古
西北
宁夏、新疆、青海、陕西、甘肃
西南
四川、云南、贵州、西藏、重庆
东北
辽宁、吉林、黑龙江
江南
上海、浙江、江苏
边塞
内蒙古,甘肃,宁夏,青海,青海
西域
新疆
徽州
安徽黄山
长安
陕西西安
武陵
湖南常德
浔阳
江西九江
姑苏
江苏苏州
苏州
江苏苏州
扬州
江苏扬州,江苏泰州,江苏南通,江苏盐城,江苏镇江,江苏南京,安徽天长,江苏淮安
燕京
北京
庐州
安徽合肥
琅琊
山东临沂
石头城
江苏南京
景德镇
江西景德镇
京口
江苏镇江
临安
浙江杭州
广陵
江苏扬州
武陵
湖南常德
钱塘
浙江杭州
金陵
江苏南京
幽州
北京
洛阳
洛阳
凉州
甘肃武威
齐州
山东济南
蜀地
四川
汝南
河南驻马店
大梁
河南开封
泰山
山东泰安
华山
陕西渭南
衡山
湖南衡阳
恒山
山西大同
嵩山
河南登封
黄山
安徽黄山
庐山
江西九江
雁荡山
浙江温州
河流
长江
四川攀枝花,四川宜宾,四川泸州,重庆,湖北宜昌,湖北荆州,湖北岳阳,湖北武汉,湖北鄂州,湖北黄石,江西九江,安徽安庆,安徽铜陵,安徽芜湖,安徽马鞍山,江苏南京,江苏镇江,江苏南通,上海
黄河
甘肃兰州,甘肃白银、宁夏石嘴山,内蒙古乌海,内蒙古巴彦淖尔, 内蒙古包头,陕西韩城,山西河津,山西永济、河南开封,河南三门峡,河南洛阳、山东滨州,山东济南
黄鹤楼
湖北武昌
滕王阁
江西南昌
岳阳楼
湖南岳阳
玉门
甘肃敦煌
阳关
甘肃敦煌
瓜州
江苏扬州
锦城
四川成都
成都
四川成都
洞庭
湖南岳阳
西湖
浙江杭州
赤壁
湖北咸宁
荒漠
荒漠地貌
草原
草原地貌
雪山
雪山地形
地震
混合标签
梅雨
华东地区,6月中-7月中,下雨
海棠
山东,陕西,湖北,江西,安徽,江苏,浙江,广东,广西;4-5月
桃花
华南、西南:2-4月
华中华东:3-4月
华北:4-5月
牡丹
全国;5月
丁香
西南,西北,华北,东北;4-5月
杏花
华中,华东,华北,东北,西南,西北 3 - 4月
梅花
全国 1-3月
杜鹃
华南,华中,华东;4-6月
荷花
全国;6-9月
桂花
华南,华中,华东 9-10 月
梨花
菊花
华北 4月
惩罚标签
白天(惩罚项)
日落-日出
夜晚(惩罚项)
日出-日落

5. 支持我们

如果您想支持我们的接口持续发展,您可以在您调用的网站等终端添加我们的链接或者文字说明

<a href="https://www.meirishici.top" target = "_blank">每日诗词 API</a>

或者,您可以帮我们多多推广宣传。

十分感谢。

6. 更新历史

2019.01.19 更新每日诗词版本为 2.2,重写推荐引擎,大幅提高推荐的应景效果。。

2018.10.31 更新每日诗词版本为 2.1 ,大幅降低推荐的重复性,可以显示更多没有看过的诗词

2018.09.23 每日诗词的第一个版本 2.0 BETA 上线