警告
本文档由一言官方撰写，本站不负责文档维护，仅进行部分修改
此处更新可能不及时，建议前往一言开发者中心查看
语句接口
此处删除了源文档中的 简介、时间规划、接口说明部分
请求地址
| 地址 | 协议 | 方法 | QPS 限制 | 线路 |
|---|---|---|---|---|
hitokoto-api.jerry.ink | HTTPS | Any | 3.5 | 新加坡 |
请注意：一言域名已加入 HSTS 预加载计划，所有请求一律以 HTTPS 方法进行。
请求参数
| 参数 | 值 | 可选 | 说明 |
|---|---|---|---|
| c | 见后表 | 是 | 句子类型 |
| encode | 见后表 | 是 | 返回编码 |
| charset | 见后表 | 是 | 字符集 |
| callback | 如：moe | 是 | 调用的异步函数 |
| 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 |
| 其他 | 返回格式化后的 JSON 文本 |
字符集（参数）
| 参数 | 说明 |
|---|---|
| utf-8 | 返回 utf-8 编码的内容 |
| gbk | 返回 gbk 编码的内容。不支持与异步函数同用 |
| 其他 | 返回 utf-8 编码的内容 |
返回格式
| 返回参数名称 | 描述 |
|---|---|
| id | 一言标识 |
| hitokoto | 一言正文。编码方式 unicode。使用 utf-8。 |
| type | 类型。请参考第三节参数的表格 |
| from | 一言的出处 |
| from_who | 一言的作者 |
| creator | 添加者 |
| creator_uid | 添加者用户标识 |
| reviewer | 审核员标识 |
| uuid | 一言唯一标识；可以链接到 (https://hitokoto.cn?uuid=[uuid]) 查看这个一言的完整信息 |
| commit_from | 提交方式 |
| created_at | 添加时间 |
| length | 句子长度 |
扩展
- 网易云 API， 目前文档尚未制作，可以先参考 介绍
- 由于网易云最近封锁严重，建议自行搭建。