语句接口
只言寄沧海,片语成一谚。 ᯠ _ ̫ _ ̥ ᯄ ੭
说明:
一谚是一个公益性项目,我们没有足够的资金来提供大流量请求接口。如果您的网站请求量较大,我们建议您本地部署一谚接口(本地端开发中)。同时,我们欢迎您向一谚赞助服务器用于部署接口,请通过QQ或者邮箱联系我们。
接口信息
本接口返回信息均采用 utf-8 编码
为求标准化与兼容性,本项目接口与一言接口几乎一致,具体见下。
地址
| 地址 | 协议 | 方法 | QPS | 线路 | 来源 |
|---|---|---|---|---|---|
| api.zitat.cn | HTTPS | GET、POST、PUT、DELETE、OPTIONS | 500 | 全球 | 一谚官方 |
参数
以下均为可选参数
| 参数 | 说明 | 值 |
|---|---|---|
| c | 句子分类 | str,见后表 |
| encode | 返回编码 | str,见后表 |
| max_length | 返回句子最大长度 | int |
| min_length | 返回句子最小长度 | int |
| select | 选择器,搭配encode=js使用 | str,默认.hitokoto |
句子分类
可选择多个分类,示例:
https://api.zitat.cn/?c=d&c=i&c=k
| 参数的值 | 说明 |
|---|---|
| a | 动画 |
| b | 漫画 |
| c | 游戏 |
| d | 文学 |
| e | 原创 |
| f | 网络 |
| g | 其他 |
| h | 影视 |
| i | 诗词 |
| j | 网易云 |
| k | 哲学 |
| l | 抖机灵 |
返回编码
| 参数的值 | 说明 |
|---|---|
| (无/缺省/其他) | 返回极简 JSON,仅含 from、from_who、hitokoto 三个键 |
json | 返回完整 JSON,包含所有字段 |
text | 返回句子纯文本 |
js | 返回同步调用函数代码,默认选择器 .hitokoto |
返回信息
当encode=text时:
返回纯文本信息
例:
text
欲买桂花同载酒,终不似、少年游。当没有encode参数或其为其他值时:
返回JSON信息
| 键 | 值 | 说明 |
|---|---|---|
| from | str | 句子出处 |
| from_who | str | 句子作者(也可以是说出这个句子的角色等) |
| hitokoto | str | 一言正文 |
例:
json
{"from":"梅花","from_who":"崔道融","hitokoto":"朔风如解意,容易莫摧残。"}当encode=json时:
返回JSON信息
| 键 | 值 | 说明 |
|---|---|---|
| from | str | 句子出处 |
| from_who | str | 句子作者(也可以是说出这个句子的角色等) |
| hitokoto | str | 句子正文 |
| id | int | 句子在其所处分类中的标识 |
| length | int | 句子正文长度 |
| type | str | 句子分类 |
| uid | int | 句子唯一标识,可前往管理界面查看句子信息 |
例:
json
{"from":"扬子江","from_who":"文天祥","hitokoto":"臣心一片磁针石,不指南方不肯休。","id":509,"length":16,"type":"i","uid":2611}