诗人搜索
接口地址:/author
请求方式:GET
响应数据类型:application/json
接口描述:
支持诗人名字,朝代,标签检索。默认使用 spell
拼音正序排序,同时还支持 viewTimes
浏览次数排序
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
dynasty | 朝代 | query | false | array | string |
name | 搜索诗人姓名 | query | false | string | |
tags | 多标签搜索 | query | false | string | |
page | 页码 | query | false | integer | |
size | 页面的大小 | query | false | integer | |
sort | 排序标准的格式为:property,(asc | desc)。默认排序顺序为升序。支持多种排序标准 | query | false | array |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | object |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
totalElements | integer(int64) | integer(int64) | |
totalPages | integer(int32) | integer(int32) | |
size | integer(int32) | integer(int32) | |
content | array | object | |
content | object | array | |
id | 诗人id | string | |
name | 诗人 | string | |
dynasty | 朝代 | string | |
brief | 简介 | string | |
highlights | 高亮内容 | object | |
number | integer(int32) | integer(int32) | |
first | boolean | ||
last | boolean | ||
numberOfElements | integer(int32) | integer(int32) | |
pageable | object | ||
offset | integer(int64) | ||
paged | boolean | ||
pageSize | integer(int32) | ||
pageNumber | integer(int32) | ||
unpaged | boolean | ||
empty | boolean |
响应示例:
{
"totalElements": 0,
"totalPages": 0,
"size": 0,
"content": [
{
"content": {
"id": "",
"name": "",
"dynasty": "",
"brief": ""
},
"highlights": {}
}
],
"number": 0,
"first": true,
"last": true,
"numberOfElements": 0,
"pageable": {
"offset": 0,
"paged": true,
"pageSize": 0,
"pageNumber": 0,
"unpaged": true
},
"empty": true
}