模块说明
item 是"商品条目"型内容模块(用于展示非卖品条目、服务条目等轻量内容):列表支持分类筛选与年月归档,返回 pager 分页信息;详情含渲染正文与自定义字段。
鉴权级别:可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/item |
可选 | 条目列表 / 分类筛选 / 归档 |
| GET | /api/item/show/{id} |
可选 | 条目详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
id |
否 | 分类 ID |
category_slug |
否 | 分类英文标识 |
year / month |
否 | 按年月归档 |
page |
否 | 页码,默认 1 |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "条目分类名",
"category_id": 0,
"item_list": [ { "id": 1, "name": "...", "thumb": "...", "...": "" } ],
"item_category": [ { "id": 2, "name": "...", "children": [] } ],
"cate_info": { "...": "当前分类详情" },
"pager": { "page": 1, "page_size": 10, "record_count": 18, "page_count": 2 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
详情
GET /api/item/show/9
{
"code": "OK",
"message": "",
"data": {
"defined": { "...": "自定义字段" },
"title": "条目详情",
"item": { "id": 9, "name": "...", "content": "<p>……</p>", "click": 32, "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- 列表键为
item_list、分类树键为item_category、详情键为item; - 与
product(真正的商品模块)区分:item为内容展示型条目,无价格/购物车概念; - 详情每次读取递增
click。