语句接口
只言寄沧海,片语成一谚。 ᯠ _ ̫ _ ̥ ᯄ ੭
说明:
一谚是一个公益性项目,我们没有足够的资金来提供大流量请求接口。如果您的网站请求量较大,我们建议您本地部署一谚接口(本地端开发中)。同时,我们欢迎您向一谚赞助服务器用于部署接口,请通过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}