加载中…
商品条目 item

模块说明

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。
添加日期:2026-10-06