接口说明
动漫也好、小说也好、网络也好，不论在哪里，我们总会看到有那么一两个句子能穿透你的心。一言指的就是一句话，可以是动漫中的台词，也可以是网络上的各种小段子。
请求地址
GET https://hitokoto.api.sylv.top/api
请求参数
| 参数 | 值 | 可选 | 说明 |
|---|
c | 见下表 | 是 | 句子类型 |
encode | json / text / js | 是 | 返回编码，默认 json |
charset | utf-8 | 是 | 字符集，默认 utf-8 |
callback | 如：moe | 是 | JSONP 异步回调函数 |
select | 默认：.hitokoto | 是 | 选择器，配合 encode=js 使用 |
min_length | 默认：0 | 是 | 返回句子的最小长度（包含） |
max_length | 默认：30 | 是 | 返回句子的最大长度（包含） |
句子类型
| 参数 | 说明 |
|---|
a | 动画 |
b | 漫画 |
c | 游戏 |
d | 文学 |
e | 原创 |
f | 来自网络 |
g | 其他 |
h | 影视 |
i | 诗词 |
j | 网易云 |
k | 哲学 |
l | 抖机灵 |
可选择多个分类，例如：?c=a&c=c。其他类型参数将作为动画类型处理。
返回编码
| 参数 | 说明 |
|---|
text | 返回纯文本 |
json | 返回格式化后的 JSON 文本（默认） |
js | 返回指定选择器的同步调用函数，默认选择器为 .hitokoto |
示例请求
GET /api?c=f
GET /api?encode=text
GET /api?callback=myCallback
GET /api?min_length=10&max_length=50
返回值
| 返回参数 | 描述 |
|---|
id | 一言标识 |
uuid | 一言唯一标识 |
hitokoto | 一言正文 |
type | 类型 |
from | 一言的出处 |
from_who | 一言的作者 |
creator | 添加者 |
creator_uid | 添加者用户标识 |
length | 句子长度 |
响应示例
{
"id": 7338,
"uuid": "75a45fd4-4f2f-45eb-80cb-6f0a7bcdfaf2",
"hitokoto": "用代码表达言语的魅力，用代码书写山河的壮丽。",
"type": "f",
"from": "一言开发者中心",
"from_who": "一言",
"creator": "DreamOne",
"creator_uid": 9209,
"length": 22
}
其他接口
GET /api/categories - 获取分类列表