Hooke / manulife-weapp

Go to a project
Toggle navigation Toggle navigation pinning
hookehuyr
f51d3f3f 1 parent 48eae832

docs: 文档模块接口字段确认 

- 更新 API 接口联调日志
  - 文档模块接口状态从"初稿"更新为"待联调"
  - weekHotAPI（本周热门资料）：字段已确认
  - fileListAPI（文档列表）：字段已确认，修正接口路径为 `/srv/?a=file&t=file_list`
  - 更新总体进度：26个接口（12个已完成，11个待联调，3个已废弃）
- 更新 CHANGELOG 记录本次文档更新
- 更新接口文档版本至 v2.4

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Inline Side-by-side
Showing 5 changed files with 338 additions and 206 deletions
...@@ -5,6 +5,30 @@ ...@@ -5,6 +5,30 @@
5 5
6 --- 6 ---
7 7
8 +## [2026-02-04] - 文档模块接口字段确认
9 +
10 +### 文档
11 +- 更新 API 接口联调日志（`docs/api-integration-log.md`）
12 + - 文档模块接口状态更新：从"初稿"更新为"待联调"
13 + - weekHotAPI（本周热门资料）：字段已确认，更新接口文档
14 + - fileListAPI（文档列表）：字段已确认，更新接口文档，修正接口路径
15 + - 更新总体进度：26个接口（12个已完成，11个待联调，3个已废弃）
16 +- 更新接口文档版本至 v2.4
17 +
18 +---
19 +
20 +**详细信息**：
21 +- **影响文件**:
22 + - `docs/api-integration-log.md` - API 联调日志更新
23 + - `src/api/file.js` - 接口文档 JSDoc 注释已更新
24 +- **技术栈**: 文档
25 +- **测试状态**: ✅ 文档已更新，待联调
26 +- **备注**:
27 + - 文档模块的两个接口字段已确认，可以开始前端集成和联调工作
28 + - fileListAPI 接口路径修正为 `/srv/?a=file&t=file_list`
29 +
30 +---
31 +
8 ## [2026-02-04] - 知识库页面新增搜索功能 32 ## [2026-02-04] - 知识库页面新增搜索功能
9 33
10 ### 新增 34 ### 新增
......
...@@ -8,26 +8,15 @@ ...@@ -8,26 +8,15 @@
8 - **已完成**: 12 (46.2%) 8 - **已完成**: 12 (46.2%)
9 - **联调中**: 0 (0%) 9 - **联调中**: 0 (0%)
10 - **已废弃**: 3 (11.5%) 10 - **已废弃**: 3 (11.5%)
11 -- **待联调**: 9 (34.6%) 11 +- **待联调**: 11 (42.3%)
12 -- **初稿（字段未确定）**: 2 (7.7%)
13 - **有阻塞**: 0 12 - **有阻塞**: 0
14 13
15 --- 14 ---
16 15
17 **📝 最近更新** (2026-02-04): 16 **📝 最近更新** (2026-02-04):
18 -- 🔧 **优化 OpenAPI 文档生成工具**： 17 +- 📝 **文档模块接口字段确认**：
19 - - 添加 CLAUDE.md 文件过滤，避免将文档文件当作 API 文档处理 18 + - weekHotAPI（本周热门资料）：字段已确认，更新接口文档，待联调
20 - - 改进新增模块检测逻辑，显示新增模块包含的所有接口 19 + - fileListAPI（文档列表）：字段已确认，更新接口文档，待联调
21 - - 优化变更检测报告，提升可读性
22 - - 修复接口信息显示为 undefined 的问题
23 -- 🗑️ **清理 Apifox API 依赖**：
24 - - 删除不再工作的 Apifox API 相关脚本（apifox-to-openapi.js、apifox-sync.js 等）
25 - - 删除 .env.apifox 配置文件
26 - - 更新 package.json，移除 api:sync 和 api:test 命令
27 - - 创建 API_GUIDE.md 使用指南，明确手动维护 OpenAPI 文档的工作流
28 -- 📝 **新增文档模块接口（初稿）**：
29 - - weekHotAPI（本周热门资料）：字段未最终确定，待联调确认
30 - - fileListAPI（文档列表）：字段未最终确定，待联调确认
31 - ✅ **收藏模块后端完成**：3 个收藏接口（addAPI、delAPI、listAPI）后端已开发完成，前端待联调 20 - ✅ **收藏模块后端完成**：3 个收藏接口（addAPI、delAPI、listAPI）后端已开发完成，前端待联调
32 - ✅ **埋点接口后端完成**：埋点接口（addAPI）后端已开发完成，前端待联调 21 - ✅ **埋点接口后端完成**：埋点接口（addAPI）后端已开发完成，前端待联调
33 - ✅ **产品模块联调完成**：产品列表接口（listAPI）联调成功 22 - ✅ **产品模块联调完成**：产品列表接口（listAPI）联调成功
...@@ -830,7 +819,7 @@ ...@@ -830,7 +819,7 @@
830 819
831 ### 文档模块 820 ### 文档模块
832 821
833 -#### 接口 1: 本周热门资料（初稿） 822 +#### 接口 1: 本周热门资料
834 823
835 **接口信息** 824 **接口信息**
836 - **接口名称**: `weekHotAPI` 825 - **接口名称**: `weekHotAPI`
...@@ -843,22 +832,22 @@ ...@@ -843,22 +832,22 @@
843 832
844 | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 | 833 | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
845 |------|------|---------|---------|---------| 834 |------|------|---------|---------|---------|
835 +| 2026-02-04 | v1.0 | 字段确认，更新接口文档 | 后端确认字段结构 | [查看](docs/api-specs/file/week_hot.md) |
846 | 2026-02-04 | v0.1 | 初稿版本 | 后端字段未确定，待联调确认 | [查看](docs/api-specs/file/week_hot.md) | 836 | 2026-02-04 | v0.1 | 初稿版本 | 后端字段未确定，待联调确认 | [查看](docs/api-specs/file/week_hot.md) |
847 837
848 **页面调试情况** 838 **页面调试情况**
849 839
850 | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 | 840 | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
851 |------|---------|---------|---------|------| 841 |------|---------|---------|---------|------|
852 -| 2026-02-04 | - | 后端字段未确定 | 待后端确认后更新 | ⏳ 待联调 | 842 +| 2026-02-04 | - | 后端字段已确认 | 待前端集成联调 | ⏳ 待联调 |
853 843
854 -**接口状态**: ⏳ 初稿 - 后端字段未确定 844 +**接口状态**: ⏳ 待联调
855 845
856 **备注**: 846 **备注**:
857 -- ⚠️ **初稿状态**：当前接口文档为初稿，后端字段可能还有调整
858 - **参数**： 847 - **参数**：
859 - `page`: 页码，从 0 开始 848 - `page`: 页码，从 0 开始
860 - `limit`: 每页数量 849 - `limit`: 每页数量
861 -- **预期返回数据结构**： 850 +- **返回数据结构**：
862 ```javascript 851 ```javascript
863 { 852 {
864 code: 1, 853 code: 1,
...@@ -876,16 +865,16 @@ ...@@ -876,16 +865,16 @@
876 } 865 }
877 } 866 }
878 ``` 867 ```
879 -- **字段确认状态**：待后端确认最终字段结构 868 +- **字段确认状态**：✅ 字段已确认
880 - 实现位置：`src/api/file.js:weekHotAPI` 869 - 实现位置：`src/api/file.js:weekHotAPI`
881 870
882 --- 871 ---
883 872
884 -#### 接口 2: 文档列表（初稿） 873 +#### 接口 2: 文档列表
885 874
886 **接口信息** 875 **接口信息**
887 - **接口名称**: `fileListAPI` 876 - **接口名称**: `fileListAPI`
888 -- **接口路径**: `/srv/?a=get_file_list&t=file_list` 877 +- **接口路径**: `/srv/?a=file&t=file_list`
889 - **请求方法**: GET 878 - **请求方法**: GET
890 - **负责页面**: 待确认 879 - **负责页面**: 待确认
891 - **负责人**: 后端团队 880 - **负责人**: 后端团队
...@@ -894,52 +883,62 @@ ...@@ -894,52 +883,62 @@
894 883
895 | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 | 884 | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
896 |------|------|---------|---------|---------| 885 |------|------|---------|---------|---------|
886 +| 2026-02-04 | v1.0 | 字段确认，更新接口文档 | 后端确认字段结构 | [查看](docs/api-specs/file/file_list.md) |
897 | 2026-02-04 | v0.1 | 初稿版本 | 后端字段未确定，待联调确认 | [查看](docs/api-specs/get_file_list/file_list.md) | 887 | 2026-02-04 | v0.1 | 初稿版本 | 后端字段未确定，待联调确认 | [查看](docs/api-specs/get_file_list/file_list.md) |
898 888
899 **页面调试情况** 889 **页面调试情况**
900 890
901 | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 | 891 | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
902 |------|---------|---------|---------|------| 892 |------|---------|---------|---------|------|
903 -| 2026-02-04 | - | 后端字段未确定 | 待后端确认后更新 | ⏳ 待联调 | 893 +| 2026-02-04 | - | 后端字段已确认 | 待前端集成联调 | ⏳ 待联调 |
904 894
905 -**接口状态**: ⏳ 初稿 - 后端字段未确定 895 +**接口状态**: ⏳ 待联调
906 896
907 **备注**: 897 **备注**:
908 -- ⚠️ **初稿状态**：当前接口文档为初稿，后端字段可能还有调整
909 - **参数**： 898 - **参数**：
910 - `client_id`: 主体 ID（可选） 899 - `client_id`: 主体 ID（可选）
911 - `cid`: 分类 ID（可选） 900 - `cid`: 分类 ID（可选）
912 - `page`: 页码（从 0 开始） 901 - `page`: 页码（从 0 开始）
913 - `limit`: 每页数量 902 - `limit`: 每页数量
914 -- **预期返回数据结构**： 903 +- **返回数据结构**：
915 ```javascript 904 ```javascript
916 { 905 {
917 code: 1, 906 code: 1,
918 data: { 907 data: {
919 - categories: [ 908 + cate: {
920 - { id: 2769851, name: "分类名称" } 909 + id: 2769851, // 分类id
910 + category_name: "分类名称", // 分类名称
911 + category_parent: 0, // 分类父级
912 + icon: "https://..." // 分类图标
913 + },
914 + children: [
915 + {
916 + id: 2769852, // 二级分类id
917 + category_name: "二级分类名",
918 + category_parent: 2769851, // 二级分类父级id
919 + icon: "https://...", // 二级分类图标
920 + list: [...], // 二级分类的附件列表
921 + children: [...] // 三级分类
922 + }
921 ], 923 ],
922 list: [ 924 list: [
923 { 925 {
924 - id: 2769856, // 产品id 926 + name: "附件名称", // 附件名称
925 - product_name: "产品名称", // 产品名 927 + value: "https://...", // 附件地址
926 - recommend: "hot", // 推荐位: normal-普通, hot-热卖 928 + extension: "pdf", // 后缀名
927 - form_sn: "customize_jsj_pnzuky", // 产品编号 929 + post_date: "2026-02-04", // 发布时间
928 - created_time: "2026-02-03 10:36:29", 930 + size: "2.5MB", // 附件大小
929 - categories: [ // 产品所属分类 931 + id: "12345" // 附件id
930 - { id: "2769851", name: "分类名称" }
931 - ],
932 - tags: [ // 产品标签
933 - { id: "2769847", name: "标签名", bg_color: "#3e5160", text_color: "#ffffff" }
934 - ]
935 } 932 }
936 ], 933 ],
937 - total: 3 // 产品总数 934 + total: 100, // 主分类附件数量
935 + max_level: "3" // 层级
938 } 936 }
939 } 937 }
940 ``` 938 ```
941 -- **字段确认状态**：待后端确认最终字段结构 939 +- **字段确认状态**：✅ 字段已确认
942 -- 实现位置：`src/api/get_file_list.js:fileListAPI` 940 +- **接口路径更正**：`/srv/?a=file&t=file_list`（之前错误为 `/srv/?a=get_file_list&t=file_list`）
941 +- 实现位置：`src/api/file.js:fileListAPI`
943 942
944 --- 943 ---
945 944
...@@ -1063,7 +1062,7 @@ ...@@ -1063,7 +1062,7 @@
1063 - [❌ 已废弃](#通用模块) - 3个接口 1062 - [❌ 已废弃](#通用模块) - 3个接口
1064 - [⏳ 待联调](#收藏模块) - 3个接口 1063 - [⏳ 待联调](#收藏模块) - 3个接口
1065 - [⏳ 待联调](#埋点模块) - 1个接口 1064 - [⏳ 待联调](#埋点模块) - 1个接口
1066 -- [⏳ 初稿 - 字段未确定](#文档模块) - 2个接口 1065 +- [⏳ 待联调](#文档模块) - 2个接口
1067 - [⏳ 后端开发中](#消息模块) - 2个接口 1066 - [⏳ 后端开发中](#消息模块) - 2个接口
1068 1067
1069 ### 按模块查看 1068 ### 按模块查看
...@@ -1073,7 +1072,7 @@ ...@@ -1073,7 +1072,7 @@
1073 - [产品](#产品模块) - ✅ 1个已完成 1072 - [产品](#产品模块) - ✅ 1个已完成
1074 - [收藏](#收藏模块) - ⏳ 3个待联调 1073 - [收藏](#收藏模块) - ⏳ 3个待联调
1075 - [埋点](#埋点模块) - ⏳ 1个待联调 1074 - [埋点](#埋点模块) - ⏳ 1个待联调
1076 -- [文档](#文档模块) - ⏳ 2个初稿 1075 +- [文档](#文档模块) - ⏳ 2个待联调
1077 - [消息](#消息模块) - ⏳ 2个后端开发中 1076 - [消息](#消息模块) - ⏳ 2个后端开发中
1078 - [知识库](#知识库模块) - ⏳ 未开始 1077 - [知识库](#知识库模块) - ⏳ 未开始
1079 - [家办](#家办模块) - ⏳ 未开始 1078 - [家办](#家办模块) - ⏳ 未开始
...@@ -1111,20 +1110,14 @@ ...@@ -1111,20 +1110,14 @@
1111 1110
1112 --- 1111 ---
1113 1112
1114 -**最后更新时间**: 2026-02-04 15:30 1113 +**最后更新时间**: 2026-02-04 18:00
1115 -**文档版本**: v2.3 1114 +**文档版本**: v2.4
1116 **更新内容**: 1115 **更新内容**:
1117 -- 📝 **新增文档模块接口（初稿）**： 1116 +- 📝 **文档模块接口字段确认**：
1118 - - weekHotAPI（本周热门资料）：字段未最终确定 1117 + - weekHotAPI（本周热门资料）：字段已确认，更新接口文档
1119 - - fileListAPI（文档列表）：字段未最终确定 1118 + - fileListAPI（文档列表）：字段已确认，更新接口文档，修正接口路径
1120 -- 🗑️ **移除 Apifox API 依赖**： 1119 +- 更新总体进度：26个接口（12个已完成，11个待联调，3个已废弃）
1121 - - 删除 apifox-to-openapi.js 等不再工作的脚本 1120 +- 文档模块从"初稿"状态更新为"待联调"状态
1122 - - 更新 package.json，简化为 api:generate 单一命令
1123 - - 明确手动维护 OpenAPI 文档的工作流
1124 -- 🔧 **API 生成工具优化**：
1125 - - 修复新增模块接口信息显示为 undefined 的问题
1126 - - 改进接口信息提取逻辑
1127 -- 更新总体进度：26个接口（12个已完成，9个待联调，2个初稿，3个已废弃）
1128 1121
1129 **历史版本**: 1122 **历史版本**:
1130 - v2.1 (2026-02-03 21:00): 产品模块联调完成 1123 - v2.1 (2026-02-03 21:00): 产品模块联调完成
......
...@@ -27,7 +27,7 @@ paths: ...@@ -27,7 +27,7 @@ paths:
27 in: query 27 in: query
28 description: '' 28 description: ''
29 required: true 29 required: true
30 - example: get_file_list 30 + example: file
31 schema: 31 schema:
32 type: string 32 type: string
33 - name: t 33 - name: t
...@@ -41,7 +41,7 @@ paths: ...@@ -41,7 +41,7 @@ paths:
41 in: query 41 in: query
42 description: 主体id 42 description: 主体id
43 required: false 43 required: false
44 - example: '30901' 44 + example: '2303465'
45 schema: 45 schema:
46 type: string 46 type: string
47 - name: limit 47 - name: limit
...@@ -62,6 +62,7 @@ paths: ...@@ -62,6 +62,7 @@ paths:
62 in: query 62 in: query
63 description: 分类id 63 description: 分类id
64 required: false 64 required: false
65 + example: '2768724'
65 schema: 66 schema:
66 type: string 67 type: string
67 responses: 68 responses:
...@@ -79,114 +80,173 @@ paths: ...@@ -79,114 +80,173 @@ paths:
79 data: 80 data:
80 type: object 81 type: object
81 properties: 82 properties:
82 - categories: 83 + cate:
84 + type: object
85 + properties:
86 + id:
87 + type: integer
88 + title: 分类id
89 + category_name:
90 + type: string
91 + title: 分类名称
92 + category_parent:
93 + type: integer
94 + title: 分类父级
95 + icon:
96 + type: string
97 + required:
98 + - id
99 + - category_name
100 + - category_parent
101 + - icon
102 + x-apifox-orders:
103 + - id
104 + - category_name
105 + - category_parent
106 + - icon
107 + title: 当前分类
108 + children:
83 type: array 109 type: array
84 items: 110 items:
85 type: object 111 type: object
86 properties: 112 properties:
87 id: 113 id:
88 type: integer 114 type: integer
89 - title: 分类id 115 + title: 二级分类id
90 - name: 116 + category_name:
91 type: string 117 type: string
92 - title: 分类名 118 + title: 二级分类名
93 - x-apifox-orders: 119 + category_parent:
94 - - id
95 - - name
96 - title: 分类列表
97 - list:
98 - type: array
99 - items:
100 - type: object
101 - properties:
102 - id:
103 type: integer 120 type: integer
104 - title: 产品id 121 + title: 二级分类名父级id
105 - product_name: 122 + icon:
106 - type: string
107 - title: 产品名
108 - recommend:
109 - type: string
110 - title: '推荐位: normal-普通, hot-热卖'
111 - form_sn:
112 - type: string
113 - created_time:
114 type: string 123 type: string
115 - title: 创建时间 124 + title: 二级分类图标
116 - categories: 125 + list:
117 type: array 126 type: array
118 items: 127 items:
119 type: object 128 type: object
120 properties: 129 properties:
121 - id:
122 - type: string
123 - title: 分类id
124 name: 130 name:
125 type: string 131 type: string
126 - title: 分类名 132 + title: 附件名称
133 + value:
134 + type: string
135 + title: 附件地址
136 + extension:
137 + type: string
138 + title: 后缀名
139 + post_date:
140 + type: string
141 + title: 发布时间
142 + size:
143 + type: string
144 + title: 附件大小
145 + id:
146 + type: string
147 + title: 附件id
127 required: 148 required:
128 - - id
129 - name 149 - name
150 + - value
151 + - extension
152 + - post_date
153 + - size
154 + - id
130 x-apifox-orders: 155 x-apifox-orders:
131 - id 156 - id
132 - name 157 - name
133 - title: 产品所属分类 158 + - value
134 - tags: 159 + - extension
160 + - post_date
161 + - size
162 + title: 二级分类的附件列表
163 + children:
135 type: array 164 type: array
136 items: 165 items:
137 type: object 166 type: object
138 properties: 167 properties:
139 id: 168 id:
169 + type: integer
170 + title: 三级分类id
171 + category_name:
140 type: string 172 type: string
141 - title: 标签id 173 + title: 三级分类名
142 - name: 174 + category_parent:
143 - type: string 175 + type: integer
144 - title: 标签名 176 + title: 三级分类名父级id
145 - bg_color: 177 + icon:
146 - type: string 178 + type: 'null'
147 - title: 标签背景色 179 + title: 三级分类图标
148 - text_color:
149 - type: string
150 - title: 标签文字色
151 - required:
152 - - id
153 - - name
154 - - bg_color
155 - - text_color
156 x-apifox-orders: 180 x-apifox-orders:
157 - id 181 - id
158 - - name 182 + - category_name
159 - - bg_color 183 + - category_parent
160 - - text_color 184 + - icon
161 - title: 产品标签 185 + title: 三级分类
186 + x-apifox-orders:
187 + - id
188 + - category_name
189 + - category_parent
190 + - icon
191 + - children
192 + - list
193 + title: 二级分类列表
194 + list:
195 + type: array
196 + items:
197 + type: object
198 + properties:
199 + name:
200 + type: string
201 + title: 附件名称
202 + value:
203 + type: string
204 + title: 附件地址
205 + extension:
206 + type: string
207 + title: 后缀名
208 + post_date:
209 + type: string
210 + title: 发布时间
211 + size:
212 + type: string
213 + title: 附件大小
214 + id:
215 + type: string
216 + title: 附件id
162 required: 217 required:
218 + - name
219 + - value
220 + - extension
221 + - post_date
222 + - size
163 - id 223 - id
164 - - product_name
165 - - recommend
166 - - form_sn
167 - - created_time
168 - - categories
169 - - tags
170 x-apifox-orders: 224 x-apifox-orders:
171 - id 225 - id
172 - - product_name 226 + - name
173 - - recommend 227 + - value
174 - - form_sn 228 + - extension
175 - - created_time 229 + - post_date
176 - - categories 230 + - size
177 - - tags 231 + title: 主分类的附件列表
178 - title: 产品列表
179 total: 232 total:
180 type: integer 233 type: integer
181 - title: 产品总数 234 + title: 主分类附件数量
235 + max_level:
236 + type: string
237 + title: 层级
182 required: 238 required:
183 - - categories 239 + - cate
240 + - children
184 - list 241 - list
185 - total 242 - total
243 + - max_level
186 x-apifox-orders: 244 x-apifox-orders:
187 - - categories 245 + - cate
246 + - children
188 - list 247 - list
189 - total 248 - total
249 + - max_level
190 required: 250 required:
191 - code 251 - code
192 - msg 252 - msg
...@@ -199,48 +259,95 @@ paths: ...@@ -199,48 +259,95 @@ paths:
199 code: 1 259 code: 1
200 msg: 0 260 msg: 0
201 data: 261 data:
202 - categories: 262 + cate:
203 - - id: 2769851 263 + id: 2768724
204 - name: '11' 264 + category_name: 入职相关
265 + category_parent: 0
266 + children:
267 + - id: 2768748
268 + category_name: 入职前
269 + category_parent: 2768724
270 + level: 1
271 + icon: >-
272 + https://cdn.ipadbiz.cn/space_35697/chenggong@2x_Fv8frv6yLpjv_-udOjNbrqWjf7Ro.png
273 + list:
274 + - name: icon-gongfo@2x.png
275 + value: >-
276 + https://cdn.ipadbiz.cn/space_2303465/icon-gongfo@2x_FupcW54dbCtf8Os3VR8-uPxBPZKJ.png
277 + extension: png
278 + post_date: '2025-11-18 09:56:10'
279 + size: 3.08 KB
280 + - name: tit01.1715066891.png
281 + value: >-
282 + https://cdn.ipadbiz.cn/space_2303465/tit01.1715066891_FkZth0fslVSIpN3_sH1QQLCvYG3I.png
283 + extension: png
284 + post_date: '2025-11-06 16:32:45'
285 + size: 23.06 KB
286 + - name: 警告1.png
287 + value: >-
288 + https://cdn.ipadbiz.cn/space_35697/警告_FgcO1_v6jMprMXk8GvWwvAS96Q0b.png
289 + extension: png
290 + post_date: '2025-11-06 16:32:12'
291 + size: 8.16 KB
292 + children:
293 + - id: 2769731
294 + category_name: 考试报名
295 + category_parent: 2768748
296 + level: 2
297 + icon: null
298 + max_depth: 2
299 + - id: 2769881
300 + category_name: 考试资料
301 + category_parent: 2768748
302 + level: 2
303 + icon: null
304 + max_depth: 2
305 + max_depth: 2
306 + - id: 2769882
307 + category_name: 入职中
308 + category_parent: 2768724
309 + level: 1
310 + icon: null
311 + list: []
312 + children:
313 + - id: 2769883
314 + category_name: 各个进度
315 + category_parent: 2769882
316 + level: 2
317 + icon: null
318 + max_depth: 2
319 + max_depth: 2
205 list: 320 list:
206 - - id: 2769856 321 + - id: 2768730
207 - product_name: '22' 322 + name: no_banner1.jpg
208 - recommend: hot 323 + value: >-
209 - form_sn: customize_jsj_pnzuky 324 + https://cdn.ipadbiz.cn/xiyuan_35697/no_banner1_Ft2CHoVnGHpiT3KNAHkyjTRObgQ1.jpg
210 - created_time: '2026-02-03 10:36:29' 325 + extension: jpg
211 - categories: 326 + post_date: '2025-11-05 18:30:38'
212 - - id: '2769851' 327 + size: 48.76 KB
213 - name: '11' 328 + - id: 2768729
214 - tags: 329 + name: '4444'
215 - - id: '2769847' 330 + value: >-
216 - name: '111' 331 + https://cdn.ipadbiz.cn/xiyuan_35697/no_banner1_Ft2CHoVnGHpiT3KNAHkyjTRObgQ1.jpg
217 - bg_color: '#3e5160' 332 + extension: jpg
218 - text_color: '#ffffff' 333 + post_date: '2025-11-05 16:02:07'
219 - - id: 2769848 334 + size: 48.76 KB
220 - product_name: '1111' 335 + - id: 2768723
221 - recommend: normal 336 + name: '1235'
222 - form_sn: customize_jsj_ivleuz 337 + value: >-
223 - created_time: '2026-02-02 16:33:01' 338 + https://cdn.ipadbiz.cn/xiyuan_35697/no_banner_FuQDBojRddPWEv0A9hM_ffoddnNC.jpg
224 - categories: 339 + extension: jpg
225 - - id: '2769851' 340 + post_date: '2025-11-05 15:10:27'
226 - name: '11' 341 + size: 78.55 KB
227 - tags: 342 + - id: 2768711
228 - - id: '2769846' 343 + name: chenggong@2x.png
229 - name: 测试1 344 + value: >-
230 - bg_color: '#1e9fff' 345 + https://cdn.ipadbiz.cn/space_35697/chenggong@2x_Fv8frv6yLpjv_-udOjNbrqWjf7Ro.png
231 - text_color: '#ffffff' 346 + extension: png
232 - - id: '2769847' 347 + post_date: '2025-11-03 13:59:04'
233 - name: '111' 348 + size: 23.08 KB
234 - bg_color: '#3e5160' 349 + total: 4
235 - text_color: '#ffffff' 350 + max_level: 2
236 - - id: 2769845
237 - product_name: '1'
238 - recommend: normal
239 - form_sn: customize_jsj_pnzuky
240 - created_time: '2026-02-02 16:22:26'
241 - categories: []
242 - tags: []
243 - total: 3
244 headers: {} 351 headers: {}
245 x-apifox-name: 成功 352 x-apifox-name: 成功
246 x-apifox-ordering: 0 353 x-apifox-ordering: 0
...@@ -252,7 +359,9 @@ components: ...@@ -252,7 +359,9 @@ components:
252 schemas: {} 359 schemas: {}
253 responses: {} 360 responses: {}
254 securitySchemes: {} 361 securitySchemes: {}
255 -servers: [] 362 +servers:
363 + - url: https://manulife.onwall.cn
364 + description: 正式环境
256 security: [] 365 security: []
257 366
258 ``` 367 ```
......
1 import { fn, fetch } from '@/api/fn'; 1 import { fn, fetch } from '@/api/fn';
2 2
3 const Api = { 3 const Api = {
4 + FileList: '/srv/?a=file&t=file_list',
4 WeekHot: '/srv/?a=file&t=week_hot', 5 WeekHot: '/srv/?a=file&t=week_hot',
5 } 6 }
6 7
7 /** 8 /**
9 + * @description 文档列表
10 + * @remark
11 + * @param {Object} params 请求参数
12 + * @param {string} params.client_id (可选) 主体id
13 + * @param {string} params.limit (可选)
14 + * @param {string} params.page (可选)
15 + * @param {string} params.cid (可选) 分类id
16 + * @returns {Promise<{
17 + * code: number; // 状态码
18 + * msg: string; // 消息
19 + * data: {
20 + * cate: {
21 + * id: integer; // 分类id
22 + * category_name: string; // 分类名称
23 + * category_parent: integer; // 分类父级
24 + * icon: string; //
25 + * };
26 + * children: Array<{
27 + * id: integer; // 二级分类id
28 + * category_name: string; // 二级分类名
29 + * category_parent: integer; // 二级分类名父级id
30 + * icon: string; // 二级分类图标
31 + * list: array; // 二级分类的附件列表
32 + * children: array; // 三级分类
33 + * }>;
34 + * list: Array<{
35 + * name: string; // 附件名称
36 + * value: string; // 附件地址
37 + * extension: string; // 后缀名
38 + * post_date: string; // 发布时间
39 + * size: string; // 附件大小
40 + * id: string; // 附件id
41 + * }>;
42 + * total: integer; // 主分类附件数量
43 + * max_level: string; // 层级
44 + * };
45 + * }>}
46 + */
47 +export const fileListAPI = (params) => fn(fetch.get(Api.FileList, params));
48 +
49 +/**
8 * @description 本周热门资料 50 * @description 本周热门资料
9 * @remark 51 * @remark
10 * @param {Object} params 请求参数 52 * @param {Object} params 请求参数
......
1 -import { fn, fetch } from '@/api/fn';
2 -
3 -const Api = {
4 - FileList: '/srv/?a=get_file_list&t=file_list',
5 -}
6 -
7 -/**
8 - * @description 文档列表
9 - * @remark
10 - * @param {Object} params 请求参数
11 - * @param {string} params.client_id (可选) 主体id
12 - * @param {string} params.limit (可选)
13 - * @param {string} params.page (可选)
14 - * @param {string} params.cid (可选) 分类id
15 - * @returns {Promise<{
16 - * code: number; // 状态码
17 - * msg: string; // 消息
18 - * data: {
19 - * categories: Array<{
20 - * id: integer; // 分类id
21 - * name: string; // 分类名
22 - * }>;
23 - * list: Array<{
24 - * id: integer; // 产品id
25 - * product_name: string; // 产品名
26 - * recommend: string; // 推荐位: normal-普通, hot-热卖
27 - * form_sn: string; //
28 - * created_time: string; // 创建时间
29 - * categories: array; // 产品所属分类
30 - * tags: array; // 产品标签
31 - * }>;
32 - * total: integer; // 产品总数
33 - * };
34 - * }>}
35 - */
36 -export const fileListAPI = (params) => fn(fetch.get(Api.FileList, params));