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