诗人搜索
接口地址:/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
}