跳到主要内容
版本:v1

诗人搜索

接口地址:/author

请求方式:GET

响应数据类型:application/json

接口描述:

支持诗人名字,朝代,标签检索。默认使用 spell 拼音正序排序,同时还支持 viewTimes 浏览次数排序

请求参数:

参数名称参数说明请求类型是否必须数据类型schema
dynasty朝代queryfalsearraystring
name搜索诗人姓名queryfalsestring
tags多标签搜索queryfalsestring
page页码queryfalseinteger
size页面的大小queryfalseinteger
sort排序标准的格式为:property,(ascdesc)。默认排序顺序为升序。支持多种排序标准queryfalsearray

响应状态:

状态码说明schema
200OKobject

响应参数:

参数名称参数说明类型schema
totalElementsinteger(int64)integer(int64)
totalPagesinteger(int32)integer(int32)
sizeinteger(int32)integer(int32)
contentarrayobject
  contentobjectarray
    id诗人idstring
    name诗人string
    dynasty朝代string
    brief简介string
  highlights高亮内容object
numberinteger(int32)integer(int32)
firstboolean
lastboolean
numberOfElementsinteger(int32)integer(int32)
pageableobject
  offsetinteger(int64)
  pagedboolean
  pageSizeinteger(int32)
  pageNumberinteger(int32)
  unpagedboolean
emptyboolean

响应示例:

{
"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
}