This commit is contained in:
2023-04-12 23:11:34 +08:00
parent 1cd210e540
commit 8d93b5607b

View File

@@ -106,30 +106,34 @@ GET /api/images
} }
``` ```
列表视图:
* GET /api/images // 标准顺序查询
* GET /api/images?page=1&pageSize=20 // 指定页码和指定分页大小
筛选规则:(数据过滤) 列表视图:(输出控制) |||
* GET /api/images?user=1234 // 筛选指定某用户发表的图片 ----|--------------------------------|-------------------------------|
* GET /api/images?choice=1234 // 筛选指定精选集下的图片 GET | /api/images | 标准顺序查询 |
* GET /api/images?like=1234 // 筛选指定用户点赞的图片 GET | /api/images?page=1&pageSize=20 | 指定页码和指定分页大小 |
* GET /api/images?tag=1234 // 筛选含有指定标签的图片
* GET /api/images?tag=1234,1235 // 筛选含有多个标签之一的图片(并集)
* GET /api/images?tag=1234&tag=1235 // 筛选含有指定多个标签的图片(交集)
* GET /api/images?user=1234&tag=123 // 筛选指定用户的指定标签图片(交集)
* GET /api/images?date=20220214+ // 时间范围(之后)
* GET /api/images?date=20220214- // 时间范围(之前)
* GET /api/images?date=2022~2023 // 时间范围(之间)
筛选规则:(数据过滤) |||
----|--------------------------------|--------------------------------
GET | /api/images?user=1234 | 筛选指定某用户发表的图片
GET | /api/images?choice=1234 | 筛选指定精选集下的图片
GET | /api/images?like=1234 | 筛选指定用户点赞的图片
GET | /api/images?tag=1234 | 筛选含有指定标签的图片
GET | /api/images?tag=1234,1235 | 筛选含有多个标签之一的图片(并集)
GET | /api/images?tag=1234&tag=1235 | 筛选含有指定多个标签的图片(交集)
GET | /api/images?user=1234&tag=123 | 筛选指定用户的指定标签图片(交集)
GET | /api/images?date=20220214+ | 时间范围(之后)
GET | /api/images?date=20220214- | 时间范围(之前)
GET | /api/images?date=2022~2023 | 时间范围(之间)
排序规则:(权重强化) 排序规则:(权重强化) |||
* GET /api/images?sort=date+ // 排序规则(相似图片查询时此项无效) ----|--------------------------------|---------------------------------
* GET /api/images?sort=like // 根据用户偏好推荐(指定用户的偏好) GET | /api/images?sort=date+ | 排序规则(相似图片查询时此项无效)
* GET /api/images?sort=history // 根据浏览记录推荐(指定用户的记录) GET | /api/images?sort=like | 根据用户偏好推荐(指定用户的偏好)
* GET /api/images?sort=choice // 根据精选集推荐(指定精选集ID, 取一组权重) GET | /api/images?sort=history | 根据浏览记录推荐(指定用户的记录)
* GET /api/images?similar=1234 // 根据指定图片的相似图片(指定图片ID) GET | /api/images?sort=choice | 根据精选集推荐(指定精选集ID, 取一组权重)
GET | /api/images?similar=1234 | 根据指定图片的相似图片(指定图片ID)
* 注意, 筛选规则为多条件取交集, 单条件的复数取并集 * 注意, 筛选规则为多条件取交集, 单条件的复数取并集