picals-platform

分页获取推荐作品列表

开发中

GET

/api/illustration/recommend

这个接口的使用场景有两种：1. 首页；2. 探索页。
在首页，只需要获取固定的一页、30个item即可；在探索页，需要配合无限滚动来不断的获取数据。
这个接口初步是打算随机获取作品，后期打算引入推荐算法，根据userId自动获取推荐数据。

请求参数

Query 参数

pageSize

string

一页的个数

可选

示例值:

current

string

当前的页数

可选

示例值:

Header 参数

Authorization

string

可选

用户鉴权的Header

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://localhost:0721/api/illustration/recommend?pageSize=30&current=1' \
--header 'Authorization: {{token}}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

message

string

状态信息

必需

data

array[object (WorkNormalItem) {7}]

返回数据

必需

string

作品id

必需

name

string

作品名称

必需

imgList

array[string]

作品图片url列表

必需

authorId

string

作者id

必需

authorName

string

作者名称

必需

authorAvatar

string

作者头像

必需

isLiked

boolean

用户是否已经喜欢

必需

示例

{
  "code": 200,
  "message": "dolor labore",
  "data": [
    {
      "id": "80",
      "name": "专经新设流",
      "imgList": [
        "http://dummyimage.com/400x400",
        "http://dummyimage.com/400x400"
      ],
      "authorId": "76",
      "authorName": "积你全特",
      "authorAvatar": "http://dummyimage.com/100x100",
      "isLiked": false
    },
    {
      "id": "31",
      "name": "京术受",
      "imgList": [
        "http://dummyimage.com/400x400",
        "http://dummyimage.com/400x400"
      ],
      "authorId": "60",
      "authorName": "格活育华",
      "authorAvatar": "http://dummyimage.com/100x100",
      "isLiked": false
    },
    {
      "id": "21",
      "name": "革办面农市对",
      "imgList": [
        "http://dummyimage.com/400x400"
      ],
      "authorId": "7",
      "authorName": "办较力会建界常",
      "authorAvatar": "http://dummyimage.com/100x100",
      "isLiked": false
    }
  ]
}

修改于 2024-04-10 16:03:17

分页获取推荐用户列表

分页获取已关注用户新作