角色列表（板块）

请求 URL：

• /getRoleListByPlate

请求方式： POST

认证： 需要登录，请在请求头携带有效的 Authorization。

1. 请求参数

2. 指定板块时的返回

当 plateId > 0 时，data 包含板块详情及角色列表。

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "plateId": 2,
    "titleDetail": "热门角色",
    "imageDetail": "https://example.com/plate-detail.png",
    "descDetail": "本板块收录近期热门角色。",
    "star": 128,
    "list": [
      {
        "id": 543,
        "name": "Marcus Johnson",
        "avatar": "https://example.com/avatar.png",
        "background": "https://example.com/background.png",
        "plateId": 2,
        "isFavorite": false
      }
    ]
  }
}

3. 未指定板块时的返回

当 plateId 不传或为 0 时，data 直接返回角色数组，不包含板块详情外层对象。

• page = 1：依次从每个当前用户可见的板块取最多 pageSize 个角色并合并返回。各板块候选角色 ID 缓存 24 小时。
• page > 1：对全部符合条件的角色进行普通分页，不再按板块分别取数。

{
  "code": 200,
  "msg": "SUCCESS",
  "data": [
    {
      "id": 543,
      "name": "Marcus Johnson",
      "avatar": "https://example.com/avatar.png",
      "background": "https://example.com/background.png",
      "plateId": 2,
      "isFavorite": false
    }
  ]
}

角色对象的完整字段说明请参考 /getRoleList 接口文档。

4. 常见状态码