本次开放的接口内容为5.7万首唐诗和3719为唐代诗人数据。
基础数据来自github:https://github.com/chinese-poetry/chinese-poetry
可搜索微信小程序【诗词酒馆】进行查看哦~
1、根据诗人名字搜索诗人信息
GET http://www.codestock.club/tang/api/poet/getPoetByName/{name}
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
name | String | 是 | 诗人姓名 |
返回值
id | 主键自增id |
name | 诗人姓名 |
description | 诗人介绍 |
num | 诗人编码 |
type | 诗人类型,目前只有1,表示唐代诗人 |
2、根据诗人编码搜索诗人信息
GET http://www.codestock.club/tang/api/poet/getPoetByNum/{num}
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
num | String | 是 | 诗人编码 |
返回值
id | 主键自增id |
name | 诗人姓名 |
description | 诗人介绍 |
num | 诗人编码 |
type | 诗人类型,目前只有1,表示唐代诗人 |
3、分页获取诗词
POST http://www.codestock.club/tang/api/poem/getPoemInfo
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
page | Integer | 是 | 页码,最小为1 |
size | Integer | 是 | 每页显示条数,最小为1,最大为50 |
keyWord | String | 否 | 根据关键字搜索时可以填写 |
返回值
total | 诗词总条数 |
list | 返回的诗词集合 |
list->id | 诗词的ID |
list->title | 诗词的标题 |
list->poem | 诗体 |
list->point | 诗的点赞数 |
list->poetName | 诗的作者姓名 |
.........................不写了,下面的都是pageHelper中的参数........................... |
4、根据id获取诗词
GET http://www.codestock.club/tang/api/poem/getPoemById/{id}
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
id | Integer | 是 | 诗词的id |
返回值
id | 诗词的ID |
title | 诗词的标题 |
poem | 诗体 |
strains | 诗的声调 |
point | 诗的点赞数 |
poet | 诗的作者信息 |
poet->id | 作者的id |
poet->name | 作者名 |
poet->description | 作者介绍 |
poet->num | 作者编号 |
poet->type | 作者类型:1唐代(目前只有这一种) |