网页产生随机句子:一言网 Api 接口说明

1、说明

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

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

简单来说,一言指的就是一句话,可以是动漫中的台词,也可以是网络上的各种小段子。
或是感动,或是开心,有或是单纯的回忆。来到这里,留下你所喜欢的那一句句话,与大家分享,这就是一言存在的目的。
*:本段文本源自hitokoto.us
2、Api

提示:旧接口http://api.hitokoto.cnhttps://sslapi.hitokoto.cn 将在未来一段时间内停用之前的旧版本api,无缝切换(切换解析)到目前的v1新api。

提示:Hitokoto预计将在2018年6-8月份做网站大版本更新。届时会有更多的新api加入,欢迎各位持续关注。v1的api不会受到大版本调整影响。

请求地址:
HTTP(s): https://v1.hitokoto.cn/

3、参数
请输入图片描述

4、返回(默认json格式)
请输入图片描述

5、示例

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.bootcss.com/bluebird/3.5.1/bluebird.core.min.js"></script>
<script src="https://cdn.bootcss.com/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>

6、 扩展

网易云 API, 目前文档尚未制作,可以先参考 Github

Last modification:August 19th, 2018 at 04:32 pm
If you think my article is useful to you, please feel free to appreciate

2 comments

  1. 乱码

    Hello,我也开发了一个 关于古诗词的 一言 API,可以根据场景智能推荐。不知道博主有没兴趣看一看,我们还提供炒鸡方便的安装 SDK。一起学习哈哈。 https://www.jinrishici.com

    1. 呵呵哒萌萌哒
      @乱码

      不错不错,大佬

Leave a Comment