一言接口使用

Author：爆胎
发布时间：July 7, 2020
2227views
8 comments
4739 words
Categories：学习

> 动漫也好、小说也好、网络也好，不论在哪里，我们总会看到有那么一两个句子能穿透你的心。我们把这些句子汇聚起来，形成一言网络，以传递更多的感动。如果可以，我们希望我们没有停止服务的那一天。
> 简单来说，一言指的就是一句话，可以是动漫中的台词，也可以是网络上的各种小段子。 或是感动，或是开心，有或是单纯的回忆。来到这里，留下你所喜欢的那一句句话，与大家分享，这就是一言存在的目的[一言官方](https://developer.hitokoto.cn)

精力有限,没时间维护更新了,请直接使用官方的接口地址。本站不再提供服务
</div>

**请求说明**
</div>

## **接口地址**

地址  |  协议  |  方法
--- | --- | --- 
https://v1.hitokoto.cn | HTTPS | Any

&nbsp;

## **返回格式**

参数名称  |  描述
--- | ---
id | 标识
hitokoto | 正文。编码方式 unicode。使用 utf-8。
type	类型 | 请参考第三节参数的表格
from | 出处
from_who |  作者
creator	 | 添加者
creator_uid |  添加者用户标识
reviewer | 审核员标识
uuid | 唯一标识
commit_from | 提交方式
created_at | 添加时间
length | 句子长度

&nbsp;

## **请求参数**

参数  |  值  |  可选  |  说明
--- | --- | --- | ---
c | 见后表 | 是 | 句子类型
encode | 见后表 | 是 | 返回编码
charset | 见后表 | 是 | 字符集
callback |  如moe | 是 | 调用的异步函数
select | 默认： | 是 | 选择器。配合 encode=js 使用
min_length | 默认：0 | 是 | 返回句子的最小长度（包含）
max_length | 默认：30	 | 是 | 返回句子的最大长度（包含）

&nbsp;

## **句子类型参数**

参数  |  描述
--- | ---
a | 动画
b | 漫画
c | 游戏
d | 文学
e | 原创
f | 来自网络
g | 其他
h | 影视
i | 诗词
j | 网易云
k | 哲学
l	 |  抖机灵

&nbsp;

## **返回编码参数**

参数  |  描述
--- | ---
text | 返回纯洁文本
json |  返回格式化后的 JSON 文本
js | 返回指定选择器的同步调用函数。默认选择器为：.hitokoto
其他 | 返回格式化后的 JSON 文本

&nbsp;

## **返回字符集参数**

&nbsp;

## **使用示例**

https://v1.itggg.cn/                 （从7种分类中随机抽取）
https://v1.itggg.cn/?c=b             （请求获得一个分类是漫画的句子）
https://v1.itggg.cn/?c=f&encode=text （请求获得一个来自网络的句子，并以纯文本格式输出）

&nbsp;

## **网页使用**

```

<p id="hitokoto_text">酝酿中...</p>
<span id="hitokoto_text">『少女祈祷中…』</span>

<script>
  fetch('https://v1.itggg.cn')
    .then(response => response.json())
    .then(data => {
      const hitokoto = document.getElementById('hitokoto_text')
      hitokoto.href = 'https://hitokoto.cn/?uuid=' + data.uuid
      hitokoto.innerText = data.hitokoto
    })
    .catch(console.error)
</script>

<script>
  axios.get('https://v1.itggg.cn')
    .then(({ data }) => {
      const hitokoto = document.getElementById('hitokoto_text')
      hitokoto.href = 'https://hitokoto.cn/?uuid=' + data.uuid
      hitokoto.innerText = data.hitokoto
    })
    .catch(console.error)
</script>

<script>
  $.ajax({
    type: 'GET',
    url: 'https://v1.itggg.cn',
    dataType: 'jsonp',
    jsonp: 'callback',
    jsonpCallback: 'hitokoto',
    success (data) {
      $('#hitokoto_text').attr('href', 'https://hitokoto.cn/?uuid=' + data.uuid)
      $('#hitokoto_text').text(data.hitokoto)
    },
    error (jqXHR, textStatus, errorThrown) {
      // 错误信息处理
      console.error(textStatus, errorThrown)
    }
  })
</script>

<script>
  var xhr = new XMLHttpRequest();
  xhr.open('get', 'https://v1.itggg.cn');
  xhr.onreadystatechange = function () {
    if (xhr.readyState === 4) {
      var data = JSON.parse(xhr.responseText);
      var hitokoto = document.getElementById('hitokoto_text');
      hitokoto.href = 'https://hitokoto.cn/?uuid=' + data.uuid
      hitokoto.innerText = data.hitokoto;
    }
  }
  xhr.send();
</script>

<script src="https://v1.itggg.cn/?encode=js&select=%23hitokoto" defer></script>
```

&nbsp;

## **JavaScript**

```
// 本示例需要浏览器支持 Promise，fetch 以及 ES6 语法。
function fetch163Playlist(playlistId) {
  return new Promise((ok, err) => {
    fetch(`https://v1.itggg.cn/nm/playlist/${playlistId}`)
      .then(response => response.json())
      .then(data => {
        const arr = [];
        data.playlist.tracks.map(function (value) {
          arr.push(value.id);
        });
        return arr;
      })
      .then(fetch163Songs)
      .then(ok)
      .catch(err);
  });
}

// 使用测试
fetch163Playlist(2158283120)
  .then(console.log)
  .catch(console.error);

fetch163Songs([28391863, 22640061])
  .then(console.log)
  .catch(console.error);
```

Last modification：June 16th, 2021 at 11:43 am

如果你想请我喝奶茶的话

8 comments

adou
2 Mouths Ago

老哥, 你的评论是原生的, 那你发布文章的富文本编辑器呢 , 使用的什么. 能否推荐一波

Reply
1. 爆胎
  2 Mouths Ago
  
  @adou
  
  啊啊，是，评论是原生的。编辑器推荐（Typora）
  
  Reply
躲闪的人士
2 Mouths Ago

Reply
adu
July 29, 2020

Reply
1. 爆胎
  July 31, 2020
  
  @adu
  
  阿杜你好
  
  Reply
孤独求败
July 9, 2020

学习了

Reply
Guyi
July 8, 2020

赞~！

Reply
1. 爆胎
  July 9, 2020
  
  @Guyi
  
  哈哈，谢谢点赞
  
  Reply