随机一言
提供随机中文名言/诗句/短句的轻量级API服务，支持json/text
GETJSON / 文本已发布版本 1.0
快速接入
QUICK START- 01查看参数说明选择请求方式与取值
- 02查看实际响应
- 03复制代码开始接入按你的开发语言选择
示例请求
每个 IP 每分钟 120 次；图片接口可能另有较低额度。限流时请按 Retry-After 等待。
请求参数
| 参数 | 类型 / 必填 | 示例 / 默认 | 说明 / 取值 |
|---|---|---|---|
type | string | text默认：json | 响应格式： json：返回JSON格式（默认）。 text：返回纯文本格式。 取值：json,text |
c | string | i默认：无 | 分类：a动画、b漫画、c游戏、d文学、e原创、f来自网络、g其他、h影视、i诗词、j网易云、k哲学、l抖机灵、其他作为动画类型处理 |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
text | string | 随机返回的名言/诗句/短句内容 |
from | string | 句子出处（可能为空字符串） |
type | string | 分类标识符（与请求参数 c 对应） |
返回示例
JSON示例：
{
"text": "人生如逆旅，我亦是行人",
"from": "临江仙·送钱穆父",
"type": "a"
}
Text示例：
人生如逆旅，我亦是行人
——《临江仙·送钱穆父》
错误示例：
{
"error": "无法获取一言数据"
}错误说明
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数无效 |
| 405 | 请求方法不支持 |
| 413 | 请求内容过大 |
| 429 | 请求过于频繁 |
| 502 | 上游服务不可用 |
| 503 | 接口维护中 |
400：检查参数；429：按 Retry-After 等待；503：维护中；502：上游暂不可用，可稍后重试或反馈。
响应结果
RESPONSE点击发送请求后查看响应。
接入代码
INTEGRATION代码根据当前请求方式和参数生成。先到在线调试填入参数，再复制到自己的程序。
站长补充的 PHP 示例
<?php
$url = 'https://api.keguan.org.cn/api/yiyan/api.php?type=text&c=i';
$ch = curl_init($url);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 5, CURLOPT_TIMEOUT => 30, CURLOPT_SSL_VERIFYPEER => true, CURLOPT_SSL_VERIFYHOST => 2]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
if ($response === false) { throw new RuntimeException(curl_error($ch)); }
curl_close($ch);
if ($status >= 400) { throw new RuntimeException('HTTP ' . $status . ': ' . $response); }
header('Content-Type: ' . ($contentType ?: 'application/octet-stream'));
echo $response;