诗词作品搜索

接口地址:/

请求方式:GET

响应数据类型:application/json

接口描述:

1. 支持标签需要搜索的标签，支持多个大的标签，每个大的标签就是一个数组，里面的小标签使用逗号分割，格式为 tags=tag1,tag2&tags=tag3,tag4,
2. 诗人Id,
3. 赏析作者Id,
4. 根据关键字全文搜索诗词，支持传入fields参数搜索条件，不传则检索所有字段。 支持字段:
   1. name 诗词名字
   2. brandName 词牌
   3. poetry 诗文正文
   4. explain 译文
   5. appreciation 赏析 5、默认使用 spell 拼音正序排序，同时还支持 viewTimes 浏览次数排序

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
tags	多标签搜索	query	false	string
appreciationAuthorId	鉴赏作者Id	query	false	array	string
poetryAuthorId	诗人Id	query	false	array	string
q	搜索词	query	false	string
fields	指定字段检索	query	false	array	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
id	诗词id	string
title	标题	string
name	诗词名	string
brandName	词牌名	string
preface	词序	string
author	诗人	string
authorId	诗人Id	string
dynasty	诗词朝代	string
poetry	内容	string
tags	标签	array	string
annotation	注释	string
audio	音频	string
highlights	高亮内容	object
number		integer(int32)	integer(int32)
first		boolean
last		boolean
numberOfElements		integer(int32)	integer(int32)
pageable		PageableObject	PageableObject
offset		integer(int64)
paged		boolean
pageSize		integer(int32)
pageNumber		integer(int32)
unpaged		boolean
empty		boolean

响应示例:

{
	"totalElements": 0,
	"totalPages": 0,
	"size": 0,
	"content": [
		{
			"content": {
				"id": "",
				"title": "",
				"name": "",
				"brandName": "",
				"preface": "",
				"author": "",
				"authorId": "",
				"dynasty": "",
				"poetry": "",
				"tags": [],
				"annotation": "",
				"audio": ""
			},
			"highlights": {}
		}
	],
	"number": 0,
	"first": true,
	"last": true,
	"numberOfElements": 0,
	"pageable": {
		"offset": 0,
		"paged": true,
		"pageSize": 0,
		"pageNumber": 0,
		"unpaged": true
	},
	"empty": true
}