随机古诗词

GET 文学阅读

随机获取一首古诗词，可指定分类

GET https://api.tinyaii.cn/v1/gushiwen/random

请求参数

参数名类型必填说明示例
categorystring可选分类ID，默认 sanbai（唐诗三百首）—

返回字段

字段类型说明
idstring诗词ID
titlestring标题
authorstring作者
dynastystring朝代
contentstring正文
translationstring白话翻译
appreciationstring赏析
annotationstring注释
tagsarray标签列表
categorystring分类ID
category_namestring分类名称

返回示例

{
  "code": 200,
  "data": {
    "id": "xxx",
    "title": "静夜思",
    "author": "李白",
    "dynasty": "唐代",
    "content": "床前明月光，疑是地上霜。",
    "category": "sanbai",
    "category_name": "唐诗三百首"
  }
}

调用示例

curl "https://api.tinyaii.cn/v1/gushiwen/random?category=<category>" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch("https://api.tinyaii.cn/v1/gushiwen/random?category=<category>", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());
import requests

resp = requests.get(
    "https://api.tinyaii.cn/v1/gushiwen/random",
    params={"category": "<category>"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)
print(resp.json())

把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。