suojin
/
mediation-platform
14
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8 Commits
1 Branch
0 Tags
11 MiB
 
Tag: Branch: Tree: 2f0449075c
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '2f0449075c'
${ noResults }
mediation-platform/doc/api.md

775 lines
17 KiB
Raw Blame History

# 公共接口
### 1. 窗口列表
- 请求地址
`GET` `/blade-system/dict/common/getServerWindowList`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"id": "1666702140550336513",
"account": "srmfy",
"name": "市法院",
"realName": "市法院"
},
{
"id": "1666740731569688578",
"account": "sjdl",
"name": "市级导览员",
"realName": "市级导览员"
}
],
"msg": "操作成功"
}
```
### 2. 所有诉求类型列表
- 请求地址
`GET` `/blade-system/dict/common/getDisputeList`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"id": "1666700063321280514",
"dictValue": "其他事项"
},
{
"id": "1666626705640546306",
"dictValue": "婚恋家庭纠纷"
}
],
"msg": "操作成功"
}
```
### 3. 街道列表
- 请求地址
`GET` `/blade-system/dict/common/getStreetList`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"id": "1666632074840399874",
"dictValue": "阜安街道"
},
{
"id": "1666697016771792897",
"dictValue": "洋河街道"
}
],
"msg": "操作成功"
}
```
# 诉求类型管理
### 1. 列表
- 请求地址
`GET` `/blade-business/serverDisputeConf/getList`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
|swId| long | N | 服务窗口ID |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"swId": "1666702666826436610",
"swName": "市卫健局",
"disputeIds": "1666699928344383490,1666629875083141122,1666697888226529282,1666697948918108162",
"disputeNames": "残疾人权益保障,劳动、社保纠纷,房产物业纠纷,涉法涉诉纠纷",
"status": 1
}
],
"msg": "操作成功"
}
```
### 2. 获取根据id获取详情
- 请求地址
`GET` `/blade-business/serverDisputeConf/detail`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
|swId| long | N | 服务窗口ID |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": {
"swId": "1666702666826436610",
"swName": "市卫健局",
"disputeIds": "1666699928344383490,1666629875083141122,1666697888226529282,1666697948918108162",
"disputeNames": "残疾人权益保障,劳动、社保纠纷,房产物业纠纷,涉法涉诉纠纷",
"status": 1
},
"msg": "操作成功"
}
```
### 3. 禁用/启用
- 请求地址
`POST` `/blade-business/serverDisputeConf/enable`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
|swId| long | N | 服务窗口ID |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": {},
"msg": "操作成功"
}
```
### 4. 删除
- 请求地址
`POST` `/blade-business/serverDisputeConf/delete`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| swId | long | N | 服务窗口ID |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": {},
"msg": "操作成功"
}
```
### 5. 保存
- 请求地址
`POST` `/blade-business/serverDisputeConf/save`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| swId | long | N | 服务窗口ID |
| disputeIds | string | N | 纠纷id, 多个以逗号分割 |
| status | int | N | 启用状态, 0:禁用, 1:启用 |
- 请求示例
```json
{
"swId": "1646019847",
"disputeIds": "123321,12341,5345",
"status": "1"
}
```
- 返回示例
```json
{
"code": 200,
"success": true,
"data": {},
"msg": "操作成功"
}
```
# 诉求登记
### 1. 列表
- 请求地址
`GET` `/blade-business/appealReg/list`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealStatus | string | N | 诉求状态 |
| startTime | string | N | 登记时间-结束 |
| endTime | string | N | 登记时间-开始 |
| appealType | string | N | 诉求类型 |
| windowId | string | N | 处理窗口ID |
| username | string | N | 代表姓名 |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"id": "122555646684684",
"appealUsernames": "张三(身份证号),李四(身份证号)",
"disputeName": "土地纠纷",
"firstRegTime": "2012-05-15 12:30",
"finishTime": "",
"problemDesc": "矛盾描述...........",
"status": 0
}
],
"msg": "操作成功"
}
```
### 2 导出诉求列表
- 请求地址
`GET` `/blade-business/appealReg/export`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealStatus | string | N | 诉求状态 |
| startTime | string | N | 登记时间-结束 |
| endTime | string | N | 登记时间-开始 |
| appealType | string | N | 诉求类型 |
| windowId | string | N | 处理窗口ID |
| username | string | N | 代表姓名 |
### 3. 根据id获取诉求信息, 上一次调解记录(点击"再次调解")
- 请求地址
`GET` `/blade-business/appealReg/getById`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | long | N | 诉求id |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"id": "122555646684684",
"streetName": "胶州市",
"disputeName": "土地纠纷",
"disposeDept": "市住建局",
"hasProtocol": "无协议书",
"hasOpinion": "无处理意见",
"hasReviewOpinion": "无复查意见",
"legalPaper": "无法律文书",
"regTime": "2012-05-15 12:30",
"problemDesc": "矛盾描述...........",
"visitorList": [
{
"id": 1546486176165,
"username": "张三",
"gender": 1,
"age": 32,
"cardno": "3708821548488178",
"address": "洋河镇",
"addressNow": "洋河镇",
"phone": "13564854126"
}
]
}
],
"msg": "操作成功"
}
```
### 4. 保存诉求登记
- 请求地址
`POST` `/blade-business/appealReg/save`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | long | N | 诉求ID |
| userList | list | N | 上述人员列表 |
| - username | string | N | 名称 |
| - gender | string | N | 性别 |
| - age | string | N | 年龄 |
| - cardno | string | N | 身份证号 |
| - address | string | N | 地址 |
| - addressNow | string | N | 现住址 |
| - phone | string | N | 联系电话 |
| disposeDept | string | N | 何单位处理过 |
| hasProtocol | string | N | 协议书 |
| hasOpinion | string | N | 处理意见 |
| hasReviewOpinion | string | N | 复查意见 |
| legalPaper | string | N | 法律文书 |
| problemDesc | string | N | 主要问题 |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": "",
"msg": "操作成功"
}
```
# 诉求调解
### 1. 调解记录列表(点击"调解记录")
- 请求地址
`GET` `/blade-business/appealMediate/getList`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | string | N | 诉求ID |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"id": "122555646684684",
"mediateTime": "2012-05-15 12:30",
"talkingAdvice": "接谈意见..........."
}
],
"msg": "操作成功"
}
```
### 2. 根据诉求id获取最新的登记信息及所有调解访谈记录列表(点击"诉求调解")
- 请求地址
`GET` `/blade-business/appealMediate/getNewestReg`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | string | N | 诉求ID |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"appealId": "诉求ID",
"appealRegId": "诉求登记ID",
"streetName": "胶州市",
"disputeName": "土地纠纷",
"disposeDept": "市住建局",
"hasProtocol": "无协议书",
"hasOpinion": "无处理意见",
"hasReviewOpinion": "无复查意见",
"legalPaper": "无法律文书",
"regTime": "2012-05-15 12:30",
"problemDesc": "矛盾描述...........",
"talkingAdviceList": [
{
"id": "调解记录id",
"talkingTime": "2022-06-03 12:05",
"talkingHis": "第一次接谈意见..........."
},{
"id": "调解记录id",
"talkingTime": "2022-06-02 10:05",
"talkingHis": "第二次接谈意见..........."
}
],
"userList": [
{
"id": 1546486176165,
"username": "张三",
"gender": 1,
"age": 32,
"cardno": "3708821548488178",
"address": "洋河镇",
"addressNow": "洋河镇",
"phone": "13564854126"
}
]
}
],
"msg": "操作成功"
}
```
### 3. 根据调解记录id获取详情, 获取 诉求信息, 本次调解记录(参数id指定的调解记录), 所有调解访谈记录列表(带id)
- 请求地址
`GET` `/blade-business/appealMediate/detail`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| mediateId | string | N | 调解记录ID |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"id": "调解记录id",
"appealId": "诉求ID",
"appealRegId": "诉求登记ID",
"streetName": "胶州市",
"disputeLevel": "事件等级",
"status": "诉求状态",
"disputeName": "土地纠纷",
"disposeDept": "市住建局",
"hasProtocol": "无协议书",
"hasOpinion": "无处理意见",
"hasReviewOpinion": "无复查意见",
"legalPaper": "无法律文书",
"regTime": "2012-05-15 12:30",
"problemDesc": "矛盾描述...........",
"attitude": "上访人意见",
"dutyDeptNames": "负责部门名称, 以逗号分割",
"copyDeptNames": "抄送部门名称, 以逗号分割",
"feedbackDeadline": "2022-12-02",
"finishDeadline": "2022-12-02",
"remark": "备注",
"submitTime": "2022-08-19",
"talkingAdviceList": [
{
"id": "调解记录id",
"talkingTime": "2022-06-03 12:05",
"talkingHis": "第一次接谈意见..........."
},{
"id": "调解记录id",
"talkingTime": "2022-06-02 10:05",
"talkingHis": "第二次接谈意见..........."
}
],
"userList": [
{
"id": 1546486176165,
"username": "张三",
"gender": 1,
"age": 32,
"cardno": "3708821548488178",
"address": "洋河镇",
"addressNow": "洋河镇",
"phone": "13564854126"
}
]
}
],
"msg": "操作成功"
}
```
### 4. 保存调解记录
- 请求地址
`POST` `/blade-business/appealMediate/save`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | String | N | 诉求id |
| appealRegId | String | N | 诉求登记ID |
| disposeDept | string | N | 何单位处理过 |
| hasProtocol | string | N | 协议书 |
| hasOpinion | string | N | 处理意见 |
| hasReviewOpinion | string | N | 复查意见 |
| legalPaper | string | N | 法律文书 |
| problemDesc | string | N | 主要问题 |
| attitude | String | N | 上访人意见 |
| talkingTime | String | N | 接谈时间 |
| talkingHis | String | N | 接谈记录 |
| talkingAdvice | String | N | 接谈意见 |
| disputeLevel | String | N | 事件等级 |
| status | String | N | 诉求状态 |
| dutyDeptIds | String | N | 负责部门ID, 以逗号分割 |
| copyDeptIds | String | N | 抄送部门ID, 以逗号分割 |
| feedbackDeadline | String | N | 反馈时限 |
| finishDeadline | String | N | 办结时限 |
| remark | String | N | 备注 |
| visitTime | String | N | 来访时间 |
| submitTime | String | N | 提交时间 |
| fileList | list | N | 上传文件列表 |
| - url | list | N | 上传文件路径 |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": "",
"msg": "操作成功"
}
```
### 5. 图片上传接口
- 请求地址
`POST` `/blade-resource/oss/endpoint/put-file`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| file | file | N | 要上传的文件 |
- 返回示例
```json
{
"code": 200,
"success": true,
"data": {
"link": "http://xxxx/file.png",
"domain": "http:xxx",
"name": "file.png",
"originalName": "file"
},
"msg": "操作成功"
}
```
# 大屏接口
### 1. 化解统计(本月, 本季, 本年, 全部)
- 请求地址
`GET` `/blade-business/report/getMediateFinish`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data": {
"mon": "20",
"quarterly": "50",
"year": "200",
"all": "300"
},
"msg": "操作成功"
}
```
### 2. 上报统计(本月, 本季, 本年, 全部)
- 请求地址
`GET` `/blade-business/report/getAppealSubmit`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data": {
"mon": "20",
"quarterly": "50",
"year": "200",
"all": "300"
},
"msg": "操作成功"
}
```
### 3. 矛盾列表(先展示当天正在处理的, 然后展示以往未办结的)
- 请求地址
`GET` `/blade-business/report/getAppealList`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"disputeName": "矛盾纠纷",
"street": "洋河镇",
"firstRegTime": "2022-05-30",
"statusName": "办结"
}
],
"msg": "操作成功"
}
```
### 4. 纠纷按月度统计(每月处理的和处理成功的)(近6个月)
- 请求地址
`GET` `/blade-business/report/getAppealByMon`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data": {
"dateList": ["一月", "二月", "三月", "四月", "五月", "六月"],
"handlerCountList": [20, 40, 32, 12, 43, 12],
"finishContList": [20, 40, 32, 12, 43, 12]
},
"msg": "操作成功"
}
```
### 5. 矛盾类型占比(最高的5个, 剩余的归为其他)
- 请求地址
`GET` `/blade-business/report/getAppealTypePercent`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data": [
{
"name": "合同纠纷",
"value": 20
},{
"name": "事故纠纷",
"value": 24
}
],
"msg": "操作成功"
}
```
### 6. 按照矛盾发生地统计每个街道的矛盾上报数量, 查询条件:时间段或选择的时间范围
- 请求地址
`GET` `/blade-business/report/getAppealSubmitCountByLoc`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data":{"胶东":12, "洋河镇":32, "铺集":23},
"msg": "操作成功"
}
```
### 7. 按照矛盾发生地统计每个街道的矛盾解决数量, 查询条件:时间段或选择的时间范围
- 请求地址
`GET` `/blade-business/report/getAppealFinishCountByLoc`
- 请求参数
|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| timeFrame | file | Y | 时段, 1:月, 2:季, 3:年 |
| startTime | string | Y | 查询开始时间 |
| endTime | string | Y | 查询结束时间 |
- 返回示例
```json
{
"code": 200,
"success": true,
"data":{"胶东":12, "洋河镇":32, "铺集":23},
"msg": "操作成功"
}
```
### 8. 矛盾热点排行(按照解决的矛盾数量, 返回排序后的列表)
- 请求地址
`GET` `/blade-business/report/getAppealHot`
- 请求参数
`无`
- 返回示例
```json
{
"code": 200,
"success": true,
"data": {
"town": [
{
"streetName": "信访办",
"num": 20
},{
"streetName": "卫健委",
"num": 13
}
],
"street": [
{
"streetName": "洋河镇",
"num": 20
},{
"streetName": "胶东街道",
"num": 13
}
]
},
"msg": "操作成功"
}
```