mediation-platform/doc/api.md

公共接口

1. 窗口列表

• 请求地址 GET /blade-system/dict/common/getServerWindowList

• 请求参数 无

• 返回示例

{
    "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

• 请求参数 无

• 返回示例

{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": "1666700063321280514",
            "dictValue": "其他事项"
        },
        {
            "id": "1666626705640546306",
            "dictValue": "婚恋家庭纠纷"
        }
    ],
    "msg": "操作成功"
}

3. 街道列表

• 请求地址 GET /blade-system/dict/common/getStreetList

• 请求参数 无

• 返回示例

{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": "1666632074840399874",
            "dictValue": "阜安街道"
        },
        {
            "id": "1666697016771792897",
            "dictValue": "洋河街道"
        }
    ],
    "msg": "操作成功"
}

诉求类型管理

1. 列表

• 请求地址 GET /blade-business/serverDisputeConf/getList

• 请求参数

参数名称	参数类型	允许为空	参数说明
swId	long	N	服务窗口ID

• 返回示例

{
	"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

• 返回示例

{
	"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

• 返回示例

{
	"code": 200,
	"success": true,
	"data": {},
	"msg": "操作成功"
}

4. 删除

• 请求地址 POST /blade-business/serverDisputeConf/delete

• 请求参数

参数名称	参数类型	允许为空	参数说明
swId	long	N	服务窗口ID

• 返回示例

{
	"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:启用

• 请求示例

{
	"swId": "1646019847",
	"disputeIds": "123321,12341,5345",
	"status": "1"
}

• 返回示例

{
	"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	代表姓名

• 返回示例

{
    "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

• 返回示例

{
    "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	主要问题

• 返回示例

{
    "code": 200,
    "success": true,
    "data": "",
    "msg": "操作成功"
}

诉求调解

1. 调解记录列表(点击"调解记录")

• 请求地址

GET /blade-business/appealMediate/getList

• 请求参数

参数名称	参数类型	允许为空	参数说明
appealId	string	N	诉求ID

• 返回示例

{
    "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

• 返回示例

{
    "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

• 返回示例

{
    "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	上传文件路径

• 返回示例

{
    "code": 200,
    "success": true,
    "data": "",
    "msg": "操作成功"
}

5. 图片上传接口

• 请求地址

POST /blade-resource/oss/endpoint/put-file

• 请求参数

参数名称	参数类型	允许为空	参数说明
file	file	N	要上传的文件

• 返回示例

{
    "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

• 请求参数

无

• 返回示例

{
    "code": 200,
    "success": true,
    "data": {
        "mon": "20",
        "quarterly": "50",
        "year": "200",
        "all": "300"
    },
    "msg": "操作成功"
}

2. 上报统计(本月, 本季, 本年, 全部)

• 请求地址

GET /blade-business/report/getAppealSubmit

• 请求参数

无

• 返回示例

{
    "code": 200,
    "success": true,
    "data": {
        "mon": "20",
        "quarterly": "50",
        "year": "200",
        "all": "300"
    },
    "msg": "操作成功"
}

3. 矛盾列表(先展示当天正在处理的, 然后展示以往未办结的)

• 请求地址

GET /blade-business/report/getAppealList

• 请求参数

无

• 返回示例

{
    "code": 200,
    "success": true,
    "data": [
        {
            "disputeName": "矛盾纠纷",
            "street": "洋河镇",
            "firstRegTime": "2022-05-30",
            "statusName": "办结"
        }
    ],
    "msg": "操作成功"
}

4. 纠纷按月度统计(每月处理的和处理成功的)(近6个月)

• 请求地址

GET /blade-business/report/getAppealByMon

• 请求参数

无

• 返回示例

{
    "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

• 请求参数

无

• 返回示例

{
    "code": 200,
    "success": true,
    "data": [
        {
            "name": "合同纠纷",
            "value": 20
        },{
            "name": "事故纠纷",
            "value": 24
        }
    ],
    "msg": "操作成功"
}

6. 按照矛盾发生地统计每个街道的矛盾上报数量, 查询条件:时间段或选择的时间范围

• 请求地址

GET /blade-business/report/getAppealSubmitCountByLoc

• 请求参数

无

• 返回示例

{
    "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	查询结束时间

• 返回示例

{
    "code": 200,
    "success": true,
    "data":{"胶东":12, "洋河镇":32, "铺集":23},
    "msg": "操作成功"
}

8. 矛盾热点排行(按照解决的矛盾数量, 返回排序后的列表)

• 请求地址

GET /blade-business/report/getAppealHot

• 请求参数

无

• 返回示例

{
    "code": 200,
    "success": true,
    "data": {
        "town": [
            {
              "streetName": "信访办",
              "num": 20
            },{
              "streetName": "卫健委",
              "num": 13
            }
        ],
        "street": [
            {
              "streetName": "洋河镇",
              "num": 20
            },{
              "streetName": "胶东街道",
              "num": 13
            }
        ]
    },
    "msg": "操作成功"
}