提供经典诗词的随机获取接口，让您轻松获取优美的中国古诗词
通过简单的GET请求获取一句随机的经典诗词及其作者信息。每次请求返回不同的诗词内容。
| 参数 | 位置 | 类型 | 描述 |
|---|---|---|---|
| 无 | - | - | 此接口不需要任何参数 |
| 字段 | 类型 | 示例 | 描述 |
|---|---|---|---|
| status | string | "success" | 请求状态：success/error |
| code | int | 200 | HTTP状态码 |
| data | object | {...} | 诗词数据对象 |
| data.content | string | "此情可待成追忆" | 诗词内容 |
| data.author | string | "李商隐《锦瑟》" | 作者及出处 |
| meta | object | {...} | 元数据信息 |
| meta.requestId | string | "f649ea66-fb1a-4beb-991c-78825e966bd4" | 请求唯一标识 |
| meta.timestamp | string | "2025/7/11 10:38:33" | 响应时间戳 |
| meta.degraded | boolean | false | 是否降级服务 |
| meta.copyright | string | "晓梦羊®工作室" | 版权信息 |
GET /api/v1 HTTP/1.1 Host: onepoem.kamyang.com Accept: application/json
随机诗词API是一个简单易用的接口，无需认证即可使用。 您可以直接通过GET请求获取随机诗词。
<div>
<!-- 外层容器 -->
<div id="poetry-content">正在加载诗句</div> <!-- 显示诗句内容的容器，初始提示文本 -->
<div id="poetry-author"></div> <!-- 显示作者信息的容器 -->
<button onclick="loadPoetry()">换一句</button> <!-- 点击按钮触发加载诗句函数 -->
</div>
<script>
// 异步函数：从API加载诗词数据
async function loadPoetry() {
try {
// 使用fetch API发送GET请求到诗词接口
const response = await fetch('https://onepoem.kamyang.com/api/v1');
// 检查响应状态，若非200-299范围则抛出错误
if (!response.ok) throw new Error('网络响应异常');
// 解析响应体为JSON格式
const data = await response.json();
// 将获取的诗句内容填充到指定元素
document.getElementById('poetry-content').textContent = data.data.content;
// 将作者信息填充到指定元素
document.getElementById('poetry-author').textContent = data.data.author;
} catch (error) {
// 错误处理：显示用户友好的错误信息
document.getElementById('poetry-content').textContent = '获取诗句失败，请重试';
// 在控制台输出详细错误信息（用户不可见）
console.error('API请求错误:', error);
}
}
// 页面加载完成后自动执行一次诗句加载
window.onload = loadPoetry;
</script>