模块说明
brand 提供品牌列表与详情接口：列表支持 class 筛选与分页，列表项带跳转到该品牌商品列表的链接字段；详情返回品牌档案。
鉴权级别：可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/brand |
可选 | 品牌列表 |
| GET | /api/brand/show/{id} |
可选 | 品牌详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
class |
否 | 首字母/分类筛选值 |
page |
否 | 页码，默认 1 |
pageSize |
否 | 每页数量（0=用后台默认） |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "品牌",
"brand_list": [ { "id": 1, "name": "...", "logo": "...", "product_list": "…品牌商品链接", "...": "" } ],
"pager": { "page": 1, "page_size": 10, "record_count": 12, "page_count": 2 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}详情
GET /api/brand/show/1
{
"code": "OK",
"message": "",
"data": {
"title": "品牌名",
"brand": { "id": 1, "name": "...", "content": "<p>……</p>", "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}注意事项
- 列表键为
brand_list、详情键为brand； - 列表项中的
product_list是该品牌商品列表页的链接（非数组），点击后进入商品模块按brand_id筛选； - 详情 ID 无效返回
422，记录不存在返回404。