每日诗词 API 是一个可以返回一句古诗词名句的接口。每日诗词 API 根据不同地点、时间、节日、季节、天气、景观、城市进行智能推荐。 如果您不以我们的接口及其提供的内容盈利,您可以免费的使用我们的 API。使用我们的 API 代表您同意了我们的 使用协议。 |
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 或者 class 为 meirishici-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>
© <?php echo date('Y'); ?> <a href="<?php $this->options->siteUrl(); ?>"><?php $this->options->title(); ?></a>.
</footer><!-- end #footer -->
3. 使用协议
使用本API接口代表您 已经同意
以下的使用协议:
一、 使用本接口,您的网站和您的行为必须满足以下条件:
-
内容和您的行为符合中国大陆法律
-
不恶意访问、攻击本接口
-
不使用自动化工具有目的地抓取保存本接口的数据
-
不伪造、仿冒、反向代理本接口
二、 满足以下条件,您可以 免费使用
本接口
-
不以本接口及其提供的内容盈利
,盈利行为包括但不仅限于:出售本接口信息、在以本接口为主体内容的页面中放置广告 等。但如果在有自己内容的页面调用本接口不受该限制。
本接口不开放商用 |
三、 本接口保留以下权利
-
对于异常访问的用户,接口在一定时间内 降低推荐质量 的权利,异常行为包括:
-
短时间内大量访问
-
-
对于以下行为,接口 拒绝服务 的权利:
-
违法网站调用
-
短时间内巨量访问,目前规则为: 5秒内单IP只能访问25次,超过的部分返回 403
-
-
自行更改协议的权利。
四、免责声明
-
本接口提供的诗词数据来源于网络,如有侵权或错漏,请联系我们删除。
-
本接口推荐结果是根据时间、地点、天气等数据使用机器自动推荐,不代表本接口及其所有者赞成键入内容及推荐结果的内容或立场。
-
本接口为开放调用,不代表本接口及其所有者赞成调用本接口的终端上的内容或立场。
-
我们尽最大可能保证接口的稳定性,但对于本接口,我们不做任何稳定性、可靠性保证,由于本接口无法访问而带来的损失,本接口以及所有者不对此负责。
五、隐私权声明
-
本接口会临时获取用户公开的
IP
数据用以推荐,会向用户电脑置入Cookies
或Token
信息记录历史推荐数据,如果您的终端用户认为此行为侵犯了他们的隐私,您应对此负责。
4. 常见问题
4.3. 接口稳定吗?
我们尽最大可能维持接口的稳定性,长效性。
技术上,我们使用 Spring-Boot, Spring-WebFlux 开发,运行在 Netty 上,使用了 Mongo 数据库和 Redis 缓存,具有一定健壮性。
但对于恶意攻击和不可抗力因素导致的接口访问异常,我们只能尽快修复。
4.4. 我们是如何推荐的?
-
根据调用的用户所在地,收集真实世界的信息,包括天气、时间、日期、事件等等
-
把真实世界信息转化为标签和其他特征,按特征拉取初步推荐池 推荐关联的标签有哪些?
-
去掉已经推荐过给该用户的诗词
-
判断诗词的好坏,并且根据一列算法对推荐池的诗词进行打分排序
-
根据真实世界的不同情况,选择不同的策略进行分段抽取,并缓存
-
从缓存池逐条返回
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月
|
惩罚标签
|
|
白天(惩罚项)
|
日落-日出
|
夜晚(惩罚项)
|
日出-日落
|