随机一言接口文档说明
“
加载中...
”
—— 加载中 ——
✨ 随机一言特性：返回文艺、励志、哲理等类型的短句，支持按分类筛选；可直接用于博客签名、APP启动页、网页装饰等场景，调用无需参数，也可通过type参数指定分类。
接口地址：
https://api.qyuan.asia/api/sjyy
请求方式：
GET（参数拼接便捷，支持POST兼容）
请求类型：
无特殊要求（浏览器/代码调用均可）
返回格式：
JSON（默认，含内容、类型、来源）
接口用途：
获取随机短句，用于网页装饰、内容填充、情感表达等场景
Header 参数
<<<<<<<<<| 参数名称
<<<<<<<<< | 参数类型
<<<<<<<<< | 示例值
<<<<<<<<< | 参数说明
|
| 无 |
— |
— |
本接口无需 Header 参数，直接调用即可 |
请求参数（Query 可选）
<<<<<<<<<| 参数名称
<<<<<<<<< | 参数类型
<<<<<<<<< | 示例值
<<<<<<<<< | 参数说明
|
| type |
string |
literary / inspirational / philosophy |
可选，指定一言分类（literary=文艺，inspirational=励志，philosophy=哲理，不传默认随机） |
| format |
string |
json / text |
可选，返回格式（json=含完整信息，text=仅返回短句，不传默认json） |
请求示例
// 1. 基础用法：随机返回一言（默认json格式）
https://api.qyuan.asia/api/sjyy
// 2. 指定分类：获取励志类型一言
https://api.qyuan.asia/api/sjyy?type=inspirational
// 3. 纯文本返回：仅获取短句内容（前端直接展示场景）
https://api.qyuan.asia/api/sjyy?format=text
// 4. 组合使用：文艺分类+纯文本
https://api.qyuan.asia/api/sjyy?type=literary&format=text
// 5. 前端直接调用（JS示例）
fetch('https://api.qyuan.asia/api/sjyy')
.then(res => res.json())
.then(data => console.log(data.content));
返回示例
// 1. 默认json格式返回（含完整信息）
{
"code": 200,
"msg": "获取成功",
"data": {
"content": "每一个不曾起舞的日子，都是对生命的辜负。",
"type": "inspirational",
"source": "尼采",
"timestamp": 1740000000000
}
}
// 2. text格式返回（仅短句）
每一个不曾起舞的日子，都是对生命的辜负。