政策相关

2026-01-11 16:48:40 +08:00
parent 110bc88462
commit b4fdcfd804
14 changed files with 1154 additions and 0 deletions
--- a/docs/app-policy-info-api.md
+++ b/docs/app-policy-info-api.md
@@ -0,0 +1,153 @@
+# 政策信息移动端接口文档
+
+## 1. 获取政策列表
+
+**接口地址：** `GET /app/policyInfo/portalList`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| pageNum | Number | 是 | 页码，默认 1 |
+| pageSize | Number | 是 | 每页条数，默认 10 |
+| searchValue | String | 否 | 政策名称搜索关键词 |
+
+**响应参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | Number | 状态码，200 表示成功 |
+| msg | String | 提示信息 |
+| total | Number | 总记录数 |
+| rows | Array | 政策列表数据 |
+
+**rows 数组元素字段：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| id | Number | 政策ID |
+| zcmc | String | 政策名称 |
+| zclx | String | 政策类型 |
+| zcLevel | String | 政策级别 |
+| sourceUnit | String | 发文单位 |
+| acceptUnit | String | 受理单位 |
+| publishTime | String | 发文时间 |
+| viewNum | Number | 浏览数 |
+| createTime | String | 创建时间 |
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "total": 100,
+  "rows": [
+    {
+      "id": 1,
+      "zcmc": "就业见习补贴",
+      "zclx": "就业政策",
+      "zcLevel": "自治区级",
+      "sourceUnit": "新疆维吾尔自治区人力资源和社会保障厅",
+      "acceptUnit": "石河子市人社局",
+      "publishTime": "2021-09-24",
+      "viewNum": 1234,
+      "createTime": "2025-01-10"
+    }
+  ]
+}
+```
+
+---
+
+## 2. 获取政策详情
+
+**接口地址：** `GET /app/policyInfo/detail/{id}`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| id | Number | 是 | 政策ID（路径参数） |
+
+**响应参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | Number | 状态码，200 表示成功 |
+| msg | String | 提示信息 |
+| data | Object | 政策详情数据 |
+
+**data 字段：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| id | Number | 政策ID |
+| zcmc | String | 政策名称 |
+| zclx | String | 政策类型 |
+| zcLevel | String | 政策级别 |
+| sourceUnit | String | 发文单位 |
+| acceptUnit | String | 受理单位 |
+| publishTime | String | 发文时间 |
+| zcContent | String | 政策内容 |
+| subsidyStandard | String | 补贴标准 |
+| handleChannel | String | 经办渠道 |
+| applyCondition | String | 申报条件 |
+| fileUrl | String | 政策文件URL |
+| fileName | String | 政策文件名称 |
+| viewNum | Number | 浏览数 |
+| createTime | String | 创建时间 |
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": {
+    "id": 1,
+    "zcmc": "就业见习补贴",
+    "zclx": "就业政策",
+    "zcLevel": "自治区级",
+    "sourceUnit": "新疆维吾尔自治区人力资源和社会保障厅",
+    "acceptUnit": "石河子市人社局",
+    "publishTime": "2021-09-24",
+    "zcContent": "支持高校毕业生和失业青年参加就业见习，提升就业能力。",
+    "subsidyStandard": "按当地最低工资标准给予见习补贴，见习单位按不低于当地最低工资标准的50%为见习人员发放岗位补助。",
+    "handleChannel": "石河子市人力资源和社会保障局就业服务窗口",
+    "applyCondition": "人社部门认定的见习单位，吸纳离校2年内未就业高校毕业生和16-24岁新疆籍失业青年参加就业见习。",
+    "fileUrl": "https://example.com/files/policy_001.pdf",
+    "fileName": "就业见习补贴政策文件.pdf",
+    "viewNum": 1234,
+    "createTime": "2025-01-10"
+  }
+}
+```
+
+---
+
+## 3. 浏览数加1
+
+**接口地址：** `POST /app/policyInfo/addViewNum/{id}`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| id | Number | 是 | 政策ID（路径参数） |
+
+**响应参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | Number | 状态码，200 表示成功 |
+| msg | String | 提示信息 |
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功"
+}
+```