端点列表
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /hitokoto/random | 随机返回一条语录(JSON) |
| GET | /hitokoto/list | 获取语录列表(支持分页、分类筛选) |
| GET | /hitokoto/categories | 获取所有分类及数量统计 |
| GET | /hitokoto/count | 获取语录总数 |
| GET | /hitokoto/:id | 按 ID 获取指定语录 |
参数说明
| 参数 | 端点 | 说明 |
|---|---|---|
category | /hitokoto/random, /list | 分类筛选(动漫/文学/诗词/电影/哲理/情感/网络) |
format | /hitokoto/random | 返回格式:json(默认)/ text(纯文本) |
callback | /hitokoto/random | JSONP 回调函数名 |
page | /hitokoto/list | 页码(默认 1) |
size | /hitokoto/list | 每页数量(默认 50,最大 200) |
使用示例
随机一条语录
GET /hitokoto/random
指定分类
GET /hitokoto/random?category=动漫
纯文本格式
GET /hitokoto/random?format=text
分页+分类
GET /hitokoto/list?category=诗词&page=1&size=10
所有分类
GET /hitokoto/categories
详细信息
- 语录总数:582 条
- 分类数量:7 个
- 返回格式:JSON(默认)/ 纯文本 / JSONP
- 零外部依赖:所有语录内置,无需调用外部 API
- 支持分页:/hitokoto/list?page=1&size=50
- 支持分类筛选:?category=动漫
在线预览
加载中...