avatar

Hexo博客添加一言

说明

一言网创立于2016年,隶属于萌创Team,目前网站主要提供一句话服务。

动漫也好、小说也好、网络也好,不论在哪里,我们总会看到有那么一两个句子能穿透你的心。我们把这些句子汇聚起来,形成一言网络,以传递更多的感动。如果可以,我们希望我们没有停止服务的那一天。

简单来说,一言指的就是一句话,可以是动漫中的台词,也可以是网络上的各种小段子。
或是感动,或是开心,有或是单纯的回忆。来到这里,留下你所喜欢的那一句句话,与大家分享,这就是一言存在的目的。(来源于一言官方网站)

API文档

这是一个Hitokoto Api更新时间表:

时间影响Api调整
2018年6月之前旧版API(http://api.hitokoto.cn和https://sslapi.hitokoto.cn)旧版API将在6月份之前以切换解析的方式合并到v1API中。也就意味着调整之后请求此API无异于请求v1API。调整后此接口的稳定性将不再受到维护。
2018年7月之前v1API(https://v1.hitokoto.cn)v1API将发布最终版本。v1接口将会在未来存在较长时间(即使v2发布,请放心使用)。
v2 发布(时间未知)v2API(域名未知)上线v2API。

目前 v1 接口已进入功能锁定阶段,任何需求请在 v2 功能申请表中提出。

由于一言目前属于公益性运营,为了保证资源的公平利用和不过度消耗公益资金,我们会定期的屏蔽某些大流量的站点。若您的站点的流量较大,您需要提前联系我们获得授权后再开始使用。对于超过阈值的站点,我们有可能会通过一定途径(例如邮件)等方式联系您,若24小时无回应则域名将暂时进入黑名单。

以下为API详细信息:

请求地址:
有两个请求地址可供您选择:

请求地址请求方式说明
https://v1.hitokoto.cn/GET/POST1、已启用 HSTS, 并已加入 HSTS Preload List 计划 2、站点QPS限制:10,超过有可能会被屏蔽 3、线路:大陆+海外
https://international.v1.hitokoto.cn/GET/POST1、已启用 HSTS, 并已加入 HSTS Preload List 计划 2、站点QPS限制:25,超过有可能会被屏蔽 3、线路:海外

参数:

参数名称类型描述
c可选Cat,即类型。提交不同的参数代表不同的类别,具体:
aAnime - 动画
bComic – 漫画
cGame – 游戏
dNovel – 小说
eMyself – 原创
fInternet – 来自网络
gOther – 其他
其他不存在参数任意类型随机取得
encode可选
text返回纯净文本
json返回不进行unicode转码的json文本
js返回指定选择器(默认.hitokoto)的同步执行函数。
其他不存在参数返回unicode转码的json文本
charset可选
utf-8返回 UTF-8 编码的内容,支持与异步函数同用。
gbk返回 GBK 编码的内容,不支持与异步函数同用。
callback可选
回调函数将返回的内容传参给指定的异步函数。

返回:(默认json格式)

返回参数名称描述
id本条一言的id。 可以链接到https://hitokoto.cn?id=[id]查看这个一言的完整信息。
hitokoto一言正文。编码方式unicode。使用utf-8。
type类型。请参考第三节参数的表格。
from一言的出处。
creator添加者。
created_at添加时间。
注意:如果encode参数为text,那么输出的只有一言正文。

示例:

https://v1.hitokoto.cn/(从7种分类中随机抽取)

https://v1.hitokoto.cn/?c=b (请求获得一个分类是漫画的句子)

https://v1.hitokoto.cn/?c=f&encode=text (请求获得一个来自网络的句子,并以纯文本格式输出)

网页使用示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<p id="hitokoto">:D 获取中...</p>
<!-- 以下写法,选取一种即可 -->

<!-- 现代写法,推荐 -->
<!-- 兼容低版本浏览器 (包括 IE),可移除 -->
<script src="https://cdn.jsdelivr.net/npm/bluebird@3/js/browser/bluebird.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/whatwg-fetch@2.0.3/fetch.min.js"></script>
<!--End-->
<script>
fetch('https://v1.hitokoto.cn')
.then(function (res){
return res.json();
})
.then(function (data) {
var hitokoto = document.getElementById('hitokoto');
hitokoto.innerText = data.hitokoto;
})
.catch(function (err) {
console.error(err);
})
</script>

<!-- 老式写法,兼容性最忧 -->
<script>
var xhr = new XMLHttpRequest();
xhr.open('get', 'https://v1.hitokoto.cn');
xhr.onreadystatechange = function () {
if (xhr.readyState === 4) {
var data = JSON.parse(xhr.responseText);
var hitokoto = document.getElementById('hitokoto');
hitokoto.innerText = data.hitokoto;
}
}
xhr.send();
</script>

<!-- 新 API 方法, 十分简洁 -->
<script src="https://v1.hitokoto.cn/?encode=js&select=%23hitokoto" defer></script>

使用方法:

以本主题matery为例:

首先打开主题的layout.ejs文件,路径theme/matery/layout/layout.ejs,将下面的代码添加到</body>之前。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<!-- 一言API -->
<!-- 现代写法,推荐 -->
<!-- 兼容低版本浏览器 (包括 IE),可移除 -->
<script src="https://cdn.jsdelivr.net/npm/bluebird@3/js/browser/bluebird.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/whatwg-fetch@2.0.3/fetch.min.js"></script>
<!--End-->
<script>
fetch('https://v1.hitokoto.cn')
.then(function (res){
return res.json();
})
.then(function (data) {
var hitokoto = document.getElementById('hitokoto');
hitokoto.innerText = data.hitokoto + '——【' + data.from + '】';
})
.catch(function (err) {
console.error(err);
})
</script>

然后再将下面的代码,添加到你想要添加的位置:

1
<p id="hitokoto">正在加载一言...</p>

最后执行部署命令查看效果即可,也可以在本地运行查看效果。

文章作者: Yafine
文章链接: https://yafine-blog.cn/posts/153b.html
版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 过客~励む
打赏
  • 微信
    微信
  • 支付寶
    支付寶

评论