模块说明
partner 提供合作伙伴的列表与详情接口:列表支持 class 筛选与分页,响应附带 image_list(所有伙伴 logo 图集,便于做滚动展示墙);详情返回伙伴档案。
鉴权级别:可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/partner |
可选 | 伙伴列表 |
| GET | /api/partner/show/{id} |
可选 | 伙伴详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
class |
否 | 分类筛选值 |
page |
否 | 页码,默认 1 |
pageSize |
否 | 每页数量(0=用后台默认) |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "合作伙伴",
"partner_list": [ { "id": 1, "name": "...", "image": "...", "...": "" } ],
"class_list": [ { "name": "全部", "value": "" } ],
"image_list": [ "logo1.png", "logo2.png" ],
"pager": { "page": 1, "page_size": 10, "record_count": 24, "page_count": 3 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
| 字段 | 说明 |
|---|---|
class_list |
可用的筛选选项 |
image_list |
当前页所有伙伴 image 字段的合集(渲染 logo 墙用) |
详情
GET /api/partner/show/5
{
"code": "OK",
"message": "",
"data": {
"title": "伙伴名",
"partner": { "id": 5, "name": "...", "content": "<p>……</p>", "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- 列表键为
partner_list、详情键为partner; - 详情 ID 无效返回
422(invalid_id),记录不存在返回404; image_list只是便捷合集,与partner_list同源,可无缝互相推导。