Files
shz-backend/docs/app-policy-info-api.md
2026-01-11 16:48:40 +08:00

154 lines
3.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 政策信息移动端接口文档
## 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": "操作成功"
}
```