模块说明
solution 提供解决方案的列表与详情接口,结构与案例一致:列表支持分类筛选(兼容 id 与 category_id)与年月归档;详情含渲染正文、自定义字段与评论。
鉴权级别:可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/solution |
可选 | 方案列表 / 分类筛选 / 归档 |
| GET | /api/solution/show/{id} |
可选 | 方案详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
id 或 category_id |
否 | 分类 ID(先取 id,为空时取 category_id) |
category_slug |
否 | 分类英文标识 |
year / month |
否 | 按年月归档 |
page |
否 | 页码,默认 1 |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "解决方案",
"category_id": 0,
"solution_list": [ { "id": 1, "name": "...", "thumb": "...", "...": "" } ],
"solution_category": [ { "id": 2, "name": "...", "children": [] } ],
"cate_info": { "...": "当前分类详情;全部时为空" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
详情
GET /api/solution/show/5(也支持 ?id= 与 category_slug+slug)
{
"code": "OK",
"message": "",
"data": {
"defined": { "...": "自定义字段" },
"title": "方案详情",
"comment": { "...": "评论数据(评论模块启用时)" },
"solution": { "id": 5, "name": "...", "content": "<p>……</p>", "click": 76, "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- 列表键为
solution_list、分类树键为solution_category、详情键为solution; - 传归档参数时分类归 0;
- 详情每次读取递增
click。