本组说明
内容接口覆盖站点全部"内容型"模块:新闻文章、客户案例、解决方案、专业人员、课程、视频、图集、下载、文档、商品条目、品牌、合作伙伴、团队、资质证书、生产设备、服务项目、门店、图片展示、FAQ 问答、自定义表单、留言板、业务咨询、招聘岗位、支持支持中心等,共 24 个模块。
这些模块的接口高度同构:列表(index)+ 详情(show) 是标配;差异集中在筛选参数、详情字段与少量特有能力(如投票、表单提交、留言提交)。
包含内容
| 模块 | 说明 | 特有能力 |
|---|---|---|
| article | 文章/新闻 | — |
| cases | 客户案例 | — |
| solution | 解决方案 | — |
| professional | 专业人员 | — |
| course | 课程 | — |
| video | 视频 | — |
| gallery | 图集 | — |
| download | 下载 | — |
| doc | 文档中心 | 两级分类树 |
| item | 商品条目 | — |
| brand | 品牌 | — |
| partner | 合作伙伴 | — |
| team | 团队 | — |
| certificate | 资质证书 | — |
| equipment | 生产设备 | — |
| service | 服务项目 | — |
| store | 门店 | — |
| onepic | 图片展示 | — |
| faq | 常见问题 | 仅列表 |
| form | 自定义表单 | 提交接口 |
| guestbook | 留言板 | 留言提交(匿名) |
| consultation | 业务咨询 | 咨询提交(匿名) |
| job | 招聘岗位 | — |
| support | 帮助支持 | — |
使用建议
- 列表接口统一支持
page翻页与分类筛选(参数名以各篇为准,常见category_id); - 列表返回中的
category/cate_info等为分类上下文,可直接渲染筛选器; - 详情接口的路径数字即数据 ID(如
/api/article/show/12),部分模块也可用 ID 查询参数; - 匿名写入类接口(留言、咨询、表单提交)有 IP 级防灌水与限流,提交失败时按《错误码与限流》处理;
- 内容详情里的
comment字段是服务端渲染好的 HTML 片段,前端可直接注入展示(注意按站点样式容器包裹)。