加载中…
内容接口

本组说明

内容接口覆盖站点全部"内容型"模块:新闻文章、客户案例、解决方案、专业人员、课程、视频、图集、下载、文档、商品条目、品牌、合作伙伴、团队、资质证书、生产设备、服务项目、门店、图片展示、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 片段,前端可直接注入展示(注意按站点样式容器包裹)。
添加日期:2026-10-06