一言


一言

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

参数

参数名称类型描述
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 (请求获得一个来自网络的句子,并以纯文本格式输出)

网页使用示例:

<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>

分享 2020-12-04 20:52:18 通过 网页 浏览(213)

共有1条评论!

  1. 匿名网友 2020-12-30 15:16:41 1#

    消灭零评论

发表评论

更换一道题!