4569 lines
112 KiB
Markdown
4569 lines
112 KiB
Markdown
# 西安应急综合执法
|
||
## 接口对接/提供APP接口/综合执法/执法机构管理
|
||
### 根据ID查询执法机构
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/agencies/{agencyId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **路径参数** | |
|
||
| `agencyId` | 执法机构ID |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | object | 执法机构信息 |
|
||
| ├ `clientId` | string | 客户端ID 或者说 临时ID |
|
||
| ├ `agencyId` | string | 执法机构唯一ID（ULID） |
|
||
| ├ `agencyName` | string | 执法机构名称 |
|
||
| ├ `agencyCode` | string | 执法机构代码（唯一标识） |
|
||
| ├ `agencySimpleCode` | string | 执法机构简码(去偶数0) |
|
||
| ├ `agencyLevel` | integer | 执法机构级别 |
|
||
| ├ `leaf` | boolean | 是否为最下级 |
|
||
| ├ `orderNum` | integer | 排序号 |
|
||
| ├ `agencyPath` | string | 路径 |
|
||
| ├ `parent` | object | 父级机构 |
|
||
| └ `children` | array | 子级机构列表 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": false,
|
||
"msg": "",
|
||
"data": {
|
||
"clientId": "",
|
||
"agencyId": "",
|
||
"agencyName": "",
|
||
"agencyCode": "",
|
||
"agencySimpleCode": "",
|
||
"agencyLevel": 0,
|
||
"leaf": false,
|
||
"orderNum": 0,
|
||
"agencyPath": "",
|
||
"parent": {},
|
||
"children": [
|
||
{
|
||
"clientId": "",
|
||
"agencyId": "",
|
||
"agencyName": "",
|
||
"agencyCode": "",
|
||
"agencySimpleCode": "",
|
||
"agencyLevel": 0,
|
||
"leaf": false,
|
||
"orderNum": 0,
|
||
"agencyPath": "",
|
||
"parent": {},
|
||
"children": [
|
||
{}
|
||
]
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
### 分页查询执法机构
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/agencies |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **Query 参数** | |
|
||
| `page` | integer | 当前页 |
|
||
| `pagesize` | integer | 每页记录数 |
|
||
| `total` | integer | 总记录数 |
|
||
| `sort` | string | 排序字段 |
|
||
| `dir` | string | 排序方向 |
|
||
| `limit` | boolean | 是否限制查询 |
|
||
| `agencyId` | string | 执法机构ID |
|
||
| `agencyCode` | string | 执法机构代码 |
|
||
| `agencyName` | string | 执法机构名称 |
|
||
| `parentId` | string | 上级机构ID |
|
||
| `agencyLevel` | string | 机构级别 |
|
||
| `contactPhone` | string | 联系电话 |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | array | 执法机构信息列表 |
|
||
| `total` | integer | 总记录数 |
|
||
| `page` | integer | 当前页 |
|
||
| `limit` | integer | 每页记录数 |
|
||
| `totalPages` | integer | 总页数 |
|
||
| `relation` | string | 数量关系 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": false,
|
||
"msg": "",
|
||
"data": [
|
||
{
|
||
"clientId": "",
|
||
"agencyId": "",
|
||
"agencyName": "",
|
||
"agencyCode": "",
|
||
"agencySimpleCode": "",
|
||
"agencyLevel": 0,
|
||
"leaf": false,
|
||
"orderNum": 0,
|
||
"agencyPath": "",
|
||
"parent": {
|
||
"clientId": "",
|
||
"agencyId": "",
|
||
"agencyName": "",
|
||
"agencyCode": "",
|
||
"agencySimpleCode": "",
|
||
"agencyLevel": 0,
|
||
"leaf": false,
|
||
"orderNum": 0,
|
||
"agencyPath": "",
|
||
"parent": {},
|
||
"children": [
|
||
{}
|
||
]
|
||
},
|
||
"children": [
|
||
{
|
||
"clientId": "",
|
||
"agencyId": "",
|
||
"agencyName": "",
|
||
"agencyCode": "",
|
||
"agencySimpleCode": "",
|
||
"agencyLevel": 0,
|
||
"leaf": false,
|
||
"orderNum": 0,
|
||
"agencyPath": "",
|
||
"parent": {},
|
||
"children": [
|
||
{}
|
||
]
|
||
}
|
||
]
|
||
}
|
||
],
|
||
"total": 0,
|
||
"page": 0,
|
||
"limit": 0,
|
||
"totalPages": 0,
|
||
"relation": ""
|
||
}
|
||
```
|
||
### 查询执法机构列表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/agencies/list |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **Query 参数** | |
|
||
| `page` | integer | 当前页 |
|
||
| `pagesize` | integer | 每页记录数 |
|
||
| `total` | integer | 总记录数 |
|
||
| `sort` | string | 排序字段 |
|
||
| `dir` | string | 排序方向 |
|
||
| `limit` | boolean | 是否限制查询 |
|
||
| `agencyId` | string | 执法机构ID |
|
||
| `agencyCode` | string | 执法机构代码 |
|
||
| `agencyName` | string | 执法机构名称 |
|
||
| `parentId` | string | 上级机构ID |
|
||
| `agencyLevel` | string | 机构级别 |
|
||
| `contactPhone` | string | 联系电话 |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | array | 执法机构信息列表 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": false,
|
||
"msg": "",
|
||
"data": [
|
||
{
|
||
"clientId": "",
|
||
"agencyId": "",
|
||
"agencyName": "",
|
||
"agencyCode": "",
|
||
"agencySimpleCode": "",
|
||
"agencyLevel": 0,
|
||
"leaf": false,
|
||
"orderNum": 0,
|
||
"agencyPath": "",
|
||
"parent": {
|
||
"clientId": "",
|
||
"agencyId": "",
|
||
"agencyName": "",
|
||
"agencyCode": "",
|
||
"agencySimpleCode": "",
|
||
"agencyLevel": 0,
|
||
"leaf": false,
|
||
"orderNum": 0,
|
||
"agencyPath": "",
|
||
"parent": {},
|
||
"children": [
|
||
{}
|
||
]
|
||
},
|
||
"children": [
|
||
{
|
||
"clientId": "",
|
||
"agencyId": "",
|
||
"agencyName": "",
|
||
"agencyCode": "",
|
||
"agencySimpleCode": "",
|
||
"agencyLevel": 0,
|
||
"leaf": false,
|
||
"orderNum": 0,
|
||
"agencyPath": "",
|
||
"parent": {},
|
||
"children": []
|
||
}
|
||
]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
## 接口对接/提供APP接口/综合执法/执法信息
|
||
### 分页查询执法信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforcements |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **Query 参数** | |
|
||
| `page` | integer | 当前页 |
|
||
| `pagesize` | integer | 每页记录数 |
|
||
| `sort` | string | 排序字段 |
|
||
| `dir` | string | 排序方向 |
|
||
| `enforcementId` | string | 执法信息ID |
|
||
| `agencyCode` | string | 机构代码 |
|
||
| `unitName` | string | 单位名称 |
|
||
| `startTime` | string | 开始时间 |
|
||
| `endTime` | string | 结束时间 |
|
||
| `currentNodeCode` | string | 当前节点code |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | array | 执法信息列表 |
|
||
| ├ `enforcementId` | string | 执法信息唯一ID |
|
||
| ├ `enterpriseId` | string | 企业ID |
|
||
| ├ `enterprise` | object | 企业信息 |
|
||
| ├ `agencyId` | string | 机构ID |
|
||
| ├ `agency` | object | 机构信息 |
|
||
| ├ `examineReportId` | string | 案件审查报告ID |
|
||
| ├ `examineReport` | object | 案件审查报告 |
|
||
| ├ `currentNodeCode` | string | 当前节点代码 |
|
||
| ├ `currentNode` | string | 当前节点 |
|
||
| ├ `createTime` | string | 创建时间 |
|
||
| ├ `updateTime` | string | 更新时间 |
|
||
| ├ `enforceChecks` | array | 现场检查记录列表 |
|
||
| ├ `checkItems` | array | 检查事项列表 |
|
||
| └ `caseInfo` | object | 案件信息 |
|
||
| `total` | integer | 总记录数 |
|
||
| `page` | integer | 当前页 |
|
||
| `limit` | integer | 每页记录数 |
|
||
| `totalPages` | integer | 总页数 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"enforcementId": "enforce-id-123",
|
||
"enterpriseId": "enterprise-id-456",
|
||
"enterprise": {
|
||
"unitName": "示例企业名称",
|
||
"unifiedSocialCode": "91370100MA3W2T4J1X"
|
||
},
|
||
"agencyId": "agency-id-789",
|
||
"agency": {
|
||
"agencyName": "示例执法机构"
|
||
},
|
||
"examineReportId": "report-id-abc",
|
||
"examineReport": {},
|
||
"currentNodeCode": "NODE_01",
|
||
"currentNode": "立案审批",
|
||
"createTime": "2023-10-26T10:00:00",
|
||
"updateTime": "2023-10-26T10:00:00",
|
||
"enforceChecks": [],
|
||
"checkItems": [],
|
||
"caseInfo": {}
|
||
}
|
||
],
|
||
"total": 1,
|
||
"page": 1,
|
||
"limit": 10,
|
||
"totalPages": 1
|
||
}
|
||
```
|
||
### 根据id查询执法信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **路径参数** | |
|
||
| `enforcementId` | string | 执法信息id |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | object | 执法信息 |
|
||
| ├ `enforcementId` | string | 执法信息唯一ID |
|
||
| ├ `enterpriseId` | string | 企业ID |
|
||
| ├ `enterprise` | object | 企业信息 |
|
||
| ├ `agencyId` | string | 机构ID |
|
||
| ├ `agency` | object | 机构信息 |
|
||
| ├ `examineReportId` | string | 案件审查报告ID |
|
||
| ├ `examineReport` | object | 案件审查报告 |
|
||
| ├ `currentNodeCode` | string | 当前节点代码 |
|
||
| ├ `currentNode` | string | 当前节点 |
|
||
| ├ `createTime` | string | 创建时间 |
|
||
| ├ `updateTime` | string | 更新时间 |
|
||
| ├ `enforceChecks` | array | 现场检查记录列表 |
|
||
| ├ `checkItems` | array | 检查事项列表 |
|
||
| └ `caseInfo` | object | 案件信息 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": {
|
||
"enforcementId": "enforce-id-123",
|
||
"enterpriseId": "enterprise-id-456",
|
||
"enterprise": {
|
||
"unitName": "示例企业名称",
|
||
"unifiedSocialCode": "91370100MA3W2T4J1X"
|
||
},
|
||
"agencyId": "agency-id-789",
|
||
"agency": {
|
||
"agencyName": "示例执法机构"
|
||
},
|
||
"examineReportId": "report-id-abc",
|
||
"examineReport": {},
|
||
"currentNodeCode": "NODE_01",
|
||
"currentNode": "立案审批",
|
||
"createTime": "2023-10-26T10:00:00",
|
||
"updateTime": "2023-10-26T10:00:00",
|
||
"enforceChecks": [],
|
||
"checkItems": [],
|
||
"caseInfo": {}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 接口对接/提供APP接口/综合执法/行政处罚流程
|
||
### 分页查询案件信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/cases |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **Query 参数** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `page` | integer | 当前页 |
|
||
| `pagesize` | integer | 每页记录数 |
|
||
| `sort` | string | 排序字段 |
|
||
| `dir` | string | 排序方向 |
|
||
| `caseName` | string | 案件名称 |
|
||
| `caseNum` | string | 案件号 |
|
||
| `fillingDate` | array | 立案时间 (数组, e.g., ["2023-01-01", "2023-01-31"]) |
|
||
| `caseClosingDate` | array | 结案时间 (数组) |
|
||
| `archiveDate` | array | 归档时间 (数组) |
|
||
| `status` | string | 案件状态 |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | array | 案件信息列表 |
|
||
| `total` | integer | 总记录数 |
|
||
| `page` | integer | 当前页 |
|
||
| `limit` | integer | 每页记录数 |
|
||
| `totalPages` | integer | 总页数 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"caseId": "case-id-123",
|
||
"caseNum": "XZCF-2023-001",
|
||
"caseName": "关于XX企业的违法案件",
|
||
"caseCause": "违反安全生产法",
|
||
"fillingDate": "2023-10-01",
|
||
"status": "已立案"
|
||
}
|
||
],
|
||
"total": 1,
|
||
"page": 1,
|
||
"limit": 10,
|
||
"totalPages": 1
|
||
}
|
||
```
|
||
|
||
### 查询案件信息（单条）
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/cases/{caseId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **路径参数** | |
|
||
| `caseId` | 案件id |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | object | 案件信息 |
|
||
| ├ `caseId` | string | 案件ID |
|
||
| ├ `caseNum` | string | 案件号 |
|
||
| ├ `caseName` | string | 案件名称 |
|
||
| ├ `caseCause` | string | 案由 |
|
||
| ├ `disposition` | string | 处理结果 |
|
||
| ├ `enterpriseId` | string | 企业ID |
|
||
| ├ `filedUserName` | string | 立案人姓名 |
|
||
| ├ `filedUserId` | string | 立案人ID |
|
||
| ├ `fillingDate` | string | 立案日期 |
|
||
| ├ `caseClosingDate` | string | 结案日期 |
|
||
| ├ `caseHandler` | string | 案件处理人 |
|
||
| ├ `archiveDate` | string | 归档日期 |
|
||
| ├ `caseSource` | string | 案件来源 |
|
||
| ├ `archivalNum` | string | 档案号 |
|
||
| ├ `shelfLife` | integer | 保存期限 |
|
||
| ├ `createdTime` | string | 创建时间 |
|
||
| ├ `updatedTime` | string | 更新时间 |
|
||
| ├ `status` | string | 案件状态 |
|
||
| ├ `enforcementId` | string | 执法信息ID |
|
||
| ├ `enforcementInfo` | object | 关联的执法信息 |
|
||
| └ `documents` | array | 关联的文书列表 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": false,
|
||
"msg": "",
|
||
"data": {
|
||
"clientId": "",
|
||
"caseId": "case-id-123",
|
||
"caseNum": "XZCF-2023-001",
|
||
"caseName": "关于XX企业的违法案件",
|
||
"caseCause": "违反安全生产法",
|
||
"disposition": "罚款2000元",
|
||
"enterpriseId": "enterprise-id-456",
|
||
"filedUserName": "张三",
|
||
"filedUserId": "user-id-111",
|
||
"fillingDate": "2023-10-01",
|
||
"caseClosingDate": "2023-10-20",
|
||
"caseHandler": "李四",
|
||
"archiveDate": "2023-10-25",
|
||
"caseSource": "群众举报",
|
||
"archivalNum": "ARCH-2023-001",
|
||
"shelfLife": 10,
|
||
"createdTime": "2023-10-01T10:00:00",
|
||
"updatedTime": "2023-10-25T14:00:00",
|
||
"status": "已结案",
|
||
"enforcementId": "enforce-id-123",
|
||
"enforcementInfo": {},
|
||
"documents": []
|
||
}
|
||
}
|
||
```
|
||
|
||
## 接口对接/提供APP接口/综合执法/执法文书管理
|
||
### 分页查询文书信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/documents |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **Query 参数** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `page` | integer | 当前页 |
|
||
| `pagesize` | integer | 每页记录数 |
|
||
| `sort` | string | 排序字段 |
|
||
| `dir` | string | 排序方向 |
|
||
| `caseId` | string | 案件id |
|
||
| `documentNo` | integer | 文书序号 |
|
||
| `caseName` | string | 案件名称 |
|
||
| `caseNum` | string | 案件id |
|
||
| `documentCode` | integer | 文书编号 |
|
||
| `documentName` | string | 文书名称 |
|
||
| `documentDate` | array | 发件时间 (数组, e.g., ["2023-01-01", "2023-01-31"]) |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | array | 文书信息列表 |
|
||
| ├ `documentId` | string | 文书ID |
|
||
| ├ `documentCode` | string | 文书编号 |
|
||
| ├ `documentNo` | integer | 文书序号 |
|
||
| ├ `documentName` | string | 文书名称 |
|
||
| ├ `documentType` | string | 文书类型 |
|
||
| ├ `documentDate` | string | 发件时间 |
|
||
| ├ `filePath` | string | 文书文件地址 |
|
||
| ├ `fileName` | string | 文书文件名称 |
|
||
| ├ `caseId` | string | 案件ID |
|
||
| ├ `caseInfo` | object | 关联的案件信息 |
|
||
| ├ `status` | string | 文书状态 |
|
||
| └ `downloadUrl` | string | 下载地址 |
|
||
| `total` | integer | 总记录数 |
|
||
| `page` | integer | 当前页 |
|
||
| `limit` | integer | 每页记录数 |
|
||
| `totalPages` | integer | 总页数 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"documentId": "doc-id-123",
|
||
"documentCode": "WJ-2023-001",
|
||
"documentNo": 1,
|
||
"documentName": "行政处罚决定书",
|
||
"documentType": "处罚决定书",
|
||
"documentDate": "2023-10-20",
|
||
"filePath": "/path/to/file.pdf",
|
||
"fileName": "行政处罚决定书.pdf",
|
||
"caseId": "case-id-123",
|
||
"caseInfo": {
|
||
"caseName": "关于XX企业的违法案件"
|
||
},
|
||
"status": "done",
|
||
"downloadUrl": "http://example.com/download/doc-id-123"
|
||
}
|
||
],
|
||
"total": 1,
|
||
"page": 1,
|
||
"limit": 10,
|
||
"totalPages": 1
|
||
}
|
||
```
|
||
|
||
### 查询文书信息（单条）
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/documents/getOneByCaseIdAndDocumentName |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **Query 参数** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `caseId` | string | 案件id |
|
||
| `documentName` | string | 文书名称 |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | object | 文书详细信息 |
|
||
| ├ `documentId` | string | 文书ID |
|
||
| ├ `documentCode` | string | 文书编号 |
|
||
| ├ `documentNo` | integer | 文书序号 |
|
||
| ├ `documentName` | string | 文书名称 |
|
||
| ├ `documentType` | string | 文书类型 |
|
||
| ├ `documentDate` | string | 发件时间 |
|
||
| ├ `documenContent` | object | 文书内容 (JSON格式) |
|
||
| ├ `filePath` | string | 文书文件地址 |
|
||
| ├ `fileName` | string | 文书文件名称 |
|
||
| ├ `caseId` | string | 案件ID |
|
||
| ├ `caseInfo` | object | 关联的案件信息 |
|
||
| ├ `status` | string | 文书状态 |
|
||
| └ `downloadUrl` | string | 下载地址 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": {
|
||
"documentId": "doc-id-456",
|
||
"documentCode": "WJ-2023-002",
|
||
"documentNo": 2,
|
||
"documentName": "现场检查记录",
|
||
"documentType": "检查记录",
|
||
"documentDate": "2023-10-21",
|
||
"documenContent": {
|
||
"checkLocation": "XX工厂车间",
|
||
"checkItems": [
|
||
{"item": "消防设施", "result": "合格"},
|
||
{"item": "安全出口", "result": "畅通"}
|
||
]
|
||
},
|
||
"filePath": "/path/to/file2.pdf",
|
||
"fileName": "现场检查记录.pdf",
|
||
"caseId": "case-id-123",
|
||
"caseInfo": {
|
||
"caseName": "关于XX企业的违法案件"
|
||
},
|
||
"status": "done",
|
||
"downloadUrl": "http://example.com/download/doc-id-456"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 接口对接/提供APP接口/综合执法/执法检查
|
||
### 分页查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforceChecks |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **Query 参数** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `page` | integer | 当前页 |
|
||
| `pagesize` | integer | 每页记录数 |
|
||
| `sort` | string | 排序字段 |
|
||
| `dir` | string | 排序方向 |
|
||
| `enforcementId` | string | 执法ID |
|
||
| `enterpriseId` | string | 企业ID |
|
||
| `checkDate` | array | 检查日期 (数组, e.g., ["2023-01-01", "2023-01-31"]) |
|
||
| `createTime` | array | 创建时间 (数组, e.g., ["2023-01-01", "2023-01-31"]) |
|
||
| `supplementVerifyResult` | string | 补充验证结果 |
|
||
| `period` | string | 周期 |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | array | 检查记录列表 |
|
||
| ├ `enforceCheckId` | string | 检查记录ID |
|
||
| ├ `checkDate` | string | 检查日期 |
|
||
| ├ `checkPlace` | string | 检查场所 |
|
||
| ├ `checkStatusMsg` | string | 检查状态 |
|
||
| ├ `checkResultMsg` | string | 检查结果 |
|
||
| ├ `rectificationDate` | string | 整改日期 |
|
||
| ├ `officerList` | array | 执法人员列表 |
|
||
| ├ `enforcementInfo` | object | 关联的执法信息 |
|
||
| │ └ `enterprise` | object | 关联的企业信息 |
|
||
| │ └ `unitName` | string | 企业名称 |
|
||
| └ `supplementVerifyResult` | string | 补充验证结果 |
|
||
| `total` | integer | 总记录数 |
|
||
| `page` | integer | 当前页 |
|
||
| `limit` | integer | 每页记录数 |
|
||
| `totalPages` | integer | 总页数 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"enforceCheckId": "check-id-123",
|
||
"checkDate": "2023-10-25",
|
||
"checkPlace": "XX企业生产车间",
|
||
"checkStatusMsg": "已检查",
|
||
"checkResultMsg": "发现隐患",
|
||
"rectificationDate": "2023-11-10",
|
||
"officerList": [
|
||
{ "officerName": "王五" }
|
||
],
|
||
"enforcementInfo": {
|
||
"enterprise": {
|
||
"unitName": "XX安全生产有限公司"
|
||
}
|
||
},
|
||
"supplementVerifyResult": "待验证"
|
||
}
|
||
],
|
||
"total": 1,
|
||
"page": 1,
|
||
"limit": 10,
|
||
"totalPages": 1
|
||
}
|
||
```
|
||
|
||
### 根据ID查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforceChecks/{enforceCheckId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **Path 参数** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `enforceCheckId` | string | 执法检查记录ID |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | object | 检查记录详情 |
|
||
| ├ `enforceCheckId` | string | 检查记录ID |
|
||
| ├ `checkDate` | string | 检查日期 |
|
||
| ├ `checkPlace` | string | 检查场所 |
|
||
| ├ `checkStatusMsg` | string | 检查状态 |
|
||
| ├ `checkResultMsg` | string | 检查结果 |
|
||
| ├ `rectificationDate` | string | 整改日期 |
|
||
| ├ `rectificationMeasures` | string | 整改措施 |
|
||
| ├ `officerList` | array | 执法人员列表 |
|
||
| │ └ `officerName` | string | 执法人员姓名 |
|
||
| ├ `enforcementInfo` | object | 关联的执法信息 |
|
||
| │ └ `enterprise` | object | 关联的企业信息 |
|
||
| │ └ `unitName` | string | 企业名称 |
|
||
| ├ `checkItems` | array | 检查项列表 |
|
||
| │ ├ `itemName` | string | 检查项名称 |
|
||
| │ ├ `enforcementBasis` | string | 执法依据 |
|
||
| │ └ `checkNote` | string | 检查说明 |
|
||
| └ `urls` | array | 附件URL列表 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": {
|
||
"enforceCheckId": "check-id-123",
|
||
"checkDate": "2023-10-25",
|
||
"checkPlace": "XX企业生产车间",
|
||
"checkStatusMsg": "已检查",
|
||
"checkResultMsg": "发现隐患",
|
||
"rectificationDate": "2023-11-10",
|
||
"rectificationMeasures": "立即停用相关设备，并进行维修。",
|
||
"officerList": [
|
||
{ "officerName": "王五" },
|
||
{ "officerName": "李六" }
|
||
],
|
||
"enforcementInfo": {
|
||
"enterprise": {
|
||
"unitName": "XX安全生产有限公司"
|
||
}
|
||
},
|
||
"checkItems": [
|
||
{
|
||
"itemName": "消防通道是否畅通",
|
||
"enforcementBasis": "《消防法》第二十八条",
|
||
"checkNote": "发现杂物堆积，已责令整改"
|
||
}
|
||
],
|
||
"urls": [
|
||
"http://example.com/path/to/photo1.jpg"
|
||
]
|
||
}
|
||
}
|
||
```
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | array | 案件信息列表 |
|
||
| ├ `caseId` | string | 案件ID |
|
||
| ├ `caseNum` | string | 案件号 |
|
||
| ├ `caseName` | string | 案件名称 |
|
||
| ├ `caseCause` | string | 案由 |
|
||
| ├ `fillingDate` | string | 立案日期 |
|
||
| ├ `caseClosingDate` | string | 结案日期 |
|
||
| ├ `archiveDate` | string | 归档日期 |
|
||
| ├ `status` | string | 案件状态 |
|
||
| ├ `enforcementId` | string | 关联的执法信息ID |
|
||
| ├ `enforcementInfo` | object | 关联的执法信息 (结构复杂, 参考“根据id查询执法信息”接口) |
|
||
| ├ `documents` | array | 案件相关文书列表 |
|
||
| `total` | integer | 总记录数 |
|
||
| `page` | integer | 当前页 |
|
||
| `limit` | integer | 每页记录数 |
|
||
| `totalPages` | integer | 总页数 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"caseId": "case-id-001",
|
||
"caseNum": "XA-YJ-2023-001",
|
||
"caseName": "关于XX企业安全生产违规的案件",
|
||
"caseCause": "未按规定进行安全培训",
|
||
"fillingDate": "2023-10-01",
|
||
"caseClosingDate": "2023-10-20",
|
||
"archiveDate": "2023-10-25",
|
||
"status": "closed",
|
||
"enforcementId": "enforce-id-123",
|
||
"enforcementInfo": {
|
||
"enterprise": {
|
||
"unitName": "示例企业名称"
|
||
}
|
||
},
|
||
"documents": []
|
||
}
|
||
],
|
||
"total": 1,
|
||
"page": 1,
|
||
"limit": 10,
|
||
"totalPages": 1
|
||
}
|
||
```
|
||
|
||
## 接口对接/提供APP接口/综合执法/现场检查
|
||
### 创建检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforceChecks |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **请求体** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `enforcementId` | string | 关联的执法ID |
|
||
| `checkDate` | string | 检查日期 (格式: yyyy-MM-dd) |
|
||
| `checkPlace` | string | 检查场所 |
|
||
| `remark` | string | 备注 |
|
||
| `checkStatus` | string | 检查状态（1.待检查 2.已检查） |
|
||
| `checkResult` | string | 检查结果 |
|
||
| `rectificationDate` | string | 整改完成日期 (格式: yyyy-MM-dd) |
|
||
| `rectificationMeasures` | string | 整改措施 |
|
||
| `officerIds` | string | 执法人员ID列表逗号分隔 |
|
||
| `checkType` | string | 检查类型 |
|
||
| `supplement` | object | 检查补充内容json串 |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | object | 创建的检查记录信息 (结构同请求体) |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"enforceCheckId": "ulid-generated-id",
|
||
"enforcementId": "enforce-id-123",
|
||
"checkDate": "2024-07-30",
|
||
"checkPlace": "企业A生产车间",
|
||
"remark": "现场检查备注信息",
|
||
"checkStatus": "2",
|
||
"checkResult": "1",
|
||
"rectificationDate": "2024-08-15",
|
||
"rectificationMeasures": "要求立即停产整改",
|
||
"officerIds": "officer-id-1,officer-id-2",
|
||
"checkType": "01",
|
||
"createdBy": "张三",
|
||
"createdAccountBy": "zhangsan",
|
||
"createTime": "2024-07-30T10:00:00",
|
||
"updateTime": "2024-07-30T10:00:00",
|
||
"supplement": {
|
||
"zdyhs": 1,
|
||
"ybyhs": 2
|
||
},
|
||
"supplementVerifyResult": "2"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforceChecks/{enforceCheckId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **路径参数** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `enforceCheckId` | string | 执法检查记录ID |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | object | 执法检查记录信息 (结构同创建接口) |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": {
|
||
"enforceCheckId": "ulid-generated-id",
|
||
"enforcementId": "enforce-id-123",
|
||
"checkDate": "2024-07-30",
|
||
"checkPlace": "企业A生产车间",
|
||
"remark": "现场检查备注信息",
|
||
"checkStatus": "2",
|
||
"checkResult": "1",
|
||
"rectificationDate": "2024-08-15",
|
||
"rectificationMeasures": "要求立即停产整改",
|
||
"officerIds": "officer-id-1,officer-id-2",
|
||
"checkType": "01",
|
||
"createdBy": "张三",
|
||
"createdAccountBy": "zhangsan",
|
||
"createTime": "2024-07-30T10:00:00",
|
||
"updateTime": "2024-07-30T10:00:00",
|
||
"supplement": {
|
||
"zdyhs": 1,
|
||
"ybyhs": 2
|
||
},
|
||
"supplementVerifyResult": "2"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 分页查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforceChecks |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| **Query 参数** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `page` | integer | 当前页 |
|
||
| `pagesize` | integer | 每页记录数 |
|
||
| `sort` | string | 排序字段 |
|
||
| `dir` | string | 排序方向 |
|
||
| `enforcementId` | string | 关联的执法ID |
|
||
| `enterpriseId` | string | 企业ID |
|
||
| `checkDate` | array | 检查日期范围 (e.g., ["2023-01-01", "2023-01-31"]) |
|
||
| `createTime` | array | 创建时间范围 (e.g., ["2023-01-01T00:00:00", "2023-01-31T23:59:59"]) |
|
||
| `supplementVerifyResult` | string | 检查补充内容审核结果 |
|
||
| `tag` | string | 查询判断 |
|
||
| **响应结果** | |
|
||
| **参数名称** | **类型** | **说明** |
|
||
| `code` | integer | 状态码 |
|
||
| `success` | boolean | 是否成功 |
|
||
| `msg` | string | 消息 |
|
||
| `data` | array | 执法检查记录列表 (结构同创建接口) |
|
||
| `total` | integer | 总记录数 |
|
||
| `page` | integer | 当前页 |
|
||
| `limit` | integer | 每页记录数 |
|
||
| `totalPages` | integer | 总页数 |
|
||
| **返回示例** | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"enforceCheckId": "ulid-generated-id",
|
||
"enforcementId": "enforce-id-123",
|
||
"checkDate": "2024-07-30",
|
||
"checkPlace": "企业A生产车间",
|
||
"remark": "现场检查备注信息",
|
||
"checkStatus": "2",
|
||
"checkResult": "1",
|
||
"rectificationDate": "2024-08-15",
|
||
"rectificationMeasures": "要求立即停产整改",
|
||
"officerIds": "officer-id-1,officer-id-2",
|
||
"checkType": "01",
|
||
"createdBy": "张三",
|
||
"createdAccountBy": "zhangsan",
|
||
"createTime": "2024-07-30T10:00:00",
|
||
"updateTime": "2024-07-30T10:00:00",
|
||
"supplement": {
|
||
"zdyhs": 1,
|
||
"ybyhs": 2
|
||
},
|
||
"supplementVerifyResult": "2"
|
||
}
|
||
],
|
||
"total": 1,
|
||
"page": 1,
|
||
"limit": 10,
|
||
"totalPages": 1
|
||
}
|
||
```
|
||
|
||
## 接口对接/提供大屏展示接口
|
||
### 查询当月执法对象数量
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/big-screen-system/zfdxsl |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数| |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | long | 当月执法对象数量 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": 128
|
||
}
|
||
```
|
||
### 查询当月执法人员数量
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/big-screen-system/zfrysl |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数| |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | long | 当月执法人员数量 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": 88
|
||
}
|
||
```
|
||
### 查询当月执法信息数量
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/big-screen-system/zfxxsl |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数| |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | long | 当月执法信息数量 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": 210
|
||
}
|
||
```
|
||
### 查询当月执法检查数量
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/big-screen-system/zfjcsl |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数| |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | long | 当月执法检查数量 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": 55
|
||
}
|
||
```
|
||
### 查询当月事故单位报告、公众举报、下级部门报告、媒体舆情监测、其他部分移送数量（当月举报统计）
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/big-screen-system/dytjs |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数| |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 举报统计结果 |
|
||
| ├ rcjdfxs | integer | 日常检查发现 |
|
||
| ├ jgjcbgs | integer | 机构监测报告 |
|
||
| ├ jbtss | integer | 举报投诉 |
|
||
| ├ sjjbs | integer | 上级交办 |
|
||
| ├ xjqbs | integer | 下级情报 |
|
||
| ├ ygbmyss | integer | 有关部门移送 |
|
||
| └ qts | integer | 其他 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"rcjdfxs": 10,
|
||
"jgjcbgs": 5,
|
||
"jbtss": 20,
|
||
"sjjbs": 2,
|
||
"xjqbs": 8,
|
||
"ygbmyss": 4,
|
||
"qts": 1
|
||
}
|
||
}
|
||
```
|
||
|
||
### 查询当月执法文书数量
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/big-screen-system/getDocumentNum |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数| |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | long | 当月执法文书数量 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": 123
|
||
}
|
||
```
|
||
|
||
### 查询当月案卷数量
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/big-screen-system/getDossiersNum |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数| |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | long | 当月案卷数量 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": 45
|
||
}
|
||
```
|
||
|
||
### 查询当月受理、调查、决定、执行数量
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/big-screen-system/getCaseNodeNum |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数| |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 节点统计结果 |
|
||
| ├ slNum | integer | 受理数 |
|
||
| ├ dcNum | integer | 调查数 |
|
||
| ├ jdNum | integer | 决定数 |
|
||
| └ zxNum | integer | 执行数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"slNum": 10,
|
||
"dcNum": 5,
|
||
"jdNum": 3,
|
||
"zxNum": 2
|
||
}
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 执法机构管理
|
||
|
||
### 创建执法机构
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/agencies |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| Agency | 执法机构对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后机构信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"agencyId": "ULID123",
|
||
"agencyName": "高新区应急局",
|
||
"agencyCode": "610100000",
|
||
"agencyLevel": 3,
|
||
"leaf": true
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询执法机构
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/agencies/{agencyId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| agencyId | string | 执法机构ID |
|
||
| 请求体参数 | |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 执法机构信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"agencyId": "ULID123",
|
||
"agencyName": "高新区应急局",
|
||
"agencyCode": "610100000",
|
||
"agencyLevel": 3,
|
||
"leaf": true
|
||
}
|
||
}
|
||
```
|
||
|
||
### 更新执法机构
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/agencies/{agencyId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| agencyId | string | 执法机构ID |
|
||
| 请求体参数 | |
|
||
| Agency | 执法机构对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后机构信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"agencyId": "ULID123",
|
||
"agencyName": "高新区应急局",
|
||
"agencyLevel": 3
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除执法机构
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/agencies/{agencyId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| agencyId | string | 执法机构ID |
|
||
| 请求体参数 | |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | null | 无数据 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功",
|
||
"data": null
|
||
}
|
||
```
|
||
|
||
### 查询执法机构列表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/agencies/list |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| page & pagesize | integer | 分页参数，可选 |
|
||
| agencyName | string | 机构名称，可选 |
|
||
| agencyCode | string | 机构代码，可选 |
|
||
| parentId | string | 上级机构ID，可选 |
|
||
| agencyLevel | string | 机构级别，可选 |
|
||
| 请求体参数 | |
|
||
| 无 | |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 机构列表 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"agencyId": "ULID123",
|
||
"agencyName": "高新区应急局"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 执法人员管理
|
||
|
||
### 创建执法人员
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/officers |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| Officer | 执法人员对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后人员信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"officerId": "ULID456",
|
||
"officerName": "张三",
|
||
"certificateNo": "XA123456",
|
||
"agencyId": "ULID123"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询执法人员
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/officers/{officerId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| officerId | string | 执法人员ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 执法人员信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"officerId": "ULID456",
|
||
"officerName": "张三",
|
||
"certificateNo": "XA123456",
|
||
"agencyId": "ULID123"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据执法证号查询执法人员
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/officers/certificate/{certificateNo} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| certificateNo | string | 执法证号 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 执法人员信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"officerId": "ULID456",
|
||
"officerName": "张三",
|
||
"certificateNo": "XA123456",
|
||
"agencyId": "ULID123"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据所属执法机构ID查询执法人员列表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/officers/agency/{agencyId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| agencyId | string | 执法机构ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 执法人员列表 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"officerId": "ULID456",
|
||
"officerName": "张三"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 更新执法人员
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/officers/{officerId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| officerId | string | 执法人员ID |
|
||
| 请求体参数 | |
|
||
| Officer | 执法人员对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后人员信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"officerId": "ULID456",
|
||
"officerName": "张三",
|
||
"certificateNo": "XA123456"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 执法检查
|
||
|
||
### 根据ID查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforceChecks/{enforceCheckId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enforceCheckId | string | 执法检查记录ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 执法检查记录详情 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"enforceCheckId": "ULID789",
|
||
"checkDate": "2025-06-21",
|
||
"checkPlace": "高新区某化工厂",
|
||
"writerName": "李四",
|
||
"checkResult": "合格",
|
||
"officerList": [
|
||
{
|
||
"officerId": "ULID456",
|
||
"officerName": "张三"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
### 分页查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforceChecks |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| page | integer | 当前页码 |
|
||
| pagesize | integer | 每页数量 |
|
||
| enforcementId | string | 执法信息ID，可选 |
|
||
| enterpriseId | string | 企业ID，可选 |
|
||
| checkDate | array<string> | 检查日期范围，可选 |
|
||
| sort | string | 排序字段，可选 |
|
||
| dir | string | 排序方向 asc/desc，可选 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 执法检查记录列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"enforceCheckId": "ULID789",
|
||
"checkDate": "2025-06-21",
|
||
"checkPlace": "高新区某化工厂",
|
||
"checkResult": "合格"
|
||
},
|
||
{
|
||
"enforceCheckId": "ULID790",
|
||
"checkDate": "2025-06-20",
|
||
"checkPlace": "碑林区某工地",
|
||
"checkResult": "不合格"
|
||
}
|
||
],
|
||
"total": 2
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 企业管理
|
||
|
||
### 创建企业信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enterprises |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| Enterprise | 企业信息对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后企业信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"enterpriseId": "ULID901",
|
||
"unitName": "西安示例化工有限公司",
|
||
"unifiedSocialCode": "91610100MA6XXXXXXX"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询企业信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enterprises/{enterpriseId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enterpriseId | string | 企业ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 企业信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"enterpriseId": "ULID901",
|
||
"unitName": "西安示例化工有限公司",
|
||
"unifiedSocialCode": "91610100MA6XXXXXXX",
|
||
"agencyId": "ULID123"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 更新企业信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enterprises/{enterpriseId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enterpriseId | string | 企业ID |
|
||
| 请求体参数 | |
|
||
| Enterprise | 企业信息对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后企业信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"enterpriseId": "ULID901",
|
||
"unitName": "西安示例化工有限公司 (更新)",
|
||
"unifiedSocialCode": "91610100MA6XXXXXXX"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除企业信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enterprises/{enterpriseId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enterpriseId | string | 企业ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
### 查询企业信息列表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enterprises |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| page | integer | 当前页 |
|
||
| pagesize | integer | 每页数量 |
|
||
| unitName | string | 企业名称，模糊匹配，可选 |
|
||
| agencyId | string | 所属机构ID，可选 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 企业信息列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"enterpriseId": "ULID901",
|
||
"unitName": "西安示例化工有限公司"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 企业信息统计
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enterprises/statistics |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| agencyId | string | 机构ID，可选 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 统计结果 |
|
||
| ├ total | integer | 企业总数 |
|
||
| └ byAgency | array<object> | 各机构企业数量 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"total": 123,
|
||
"byAgency": [
|
||
{ "agencyId": "ULID123", "count": 60 },
|
||
{ "agencyId": "ULID124", "count": 63 }
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
### 导出企业信息 Excel
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enterprises/exportExcel |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | octet-stream |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| agencyId | string | 机构ID，可选 |
|
||
| unitName | string | 企业名称，可选 |
|
||
| 响应结果 | 文件流 | 下载 Excel 文件。
|
||
|
||
### 批量导入企业信息(importFile)
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enterprises/importFile |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| file | file | Excel 文件 (multipart/form-data) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "导入成功"
|
||
}
|
||
```
|
||
|
||
### 根据机构查询企业列表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enterprises/agency/{agencyId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| agencyId | string | 机构ID |
|
||
| 查询参数 | |
|
||
| page | integer | 当前页 |
|
||
| pagesize | integer | 每页数量 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 企业信息列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"enterpriseId": "ULID901",
|
||
"unitName": "西安示例化工有限公司"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 投诉举报
|
||
|
||
### 创建投诉举报
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/complaints |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| Complaint | 投诉举报对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后投诉举报 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"complaintId": "ULID1001",
|
||
"enterpriseId": "ULID901",
|
||
"title": "安全隐患举报"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询投诉举报
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/complaints/{complaintId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| complaintId | string | 投诉举报ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 投诉举报详情 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"complaintId": "ULID1001",
|
||
"enterpriseId": "ULID901",
|
||
"title": "安全隐患举报",
|
||
"status": "待处理"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据被投诉企业ID查询投诉举报列表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/complaints/enterprise/{enterpriseId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enterpriseId | string | 企业ID |
|
||
| 查询参数 | |
|
||
| page | integer | 当前页 |
|
||
| pagesize | integer | 每页数量 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 投诉举报列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"complaintId": "ULID1001",
|
||
"title": "安全隐患举报",
|
||
"status": "待处理"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 更新投诉举报
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/complaints/{complaintId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| complaintId | string | 投诉举报ID |
|
||
| 请求体参数 | |
|
||
| Complaint | 投诉举报对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后投诉举报 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"complaintId": "ULID1001",
|
||
"status": "已处理"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除投诉举报
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/complaints/{complaintId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| complaintId | string | 投诉举报ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 举报核查管理
|
||
|
||
### 创建举报核查信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/reportChecks |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| ReportCheck | 举报核查对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后举报核查信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"reportCheckId": "ULID1101",
|
||
"complaintId": "ULID1001",
|
||
"status": "待核查"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 更新举报核查信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/reportChecks/{reportCheckId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| reportCheckId | string | 举报核查ID |
|
||
| 请求体参数 | |
|
||
| ReportCheck | 举报核查对象 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后举报核查信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"reportCheckId": "ULID1101",
|
||
"status": "已核查"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 转交举报核查
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/reportChecks/{reportCheckId}/transfer |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| reportCheckId | string | 举报核查ID |
|
||
| 请求体参数 | |
|
||
| targetAgencyId | string | 转交目标机构ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "转交成功"
|
||
}
|
||
```
|
||
|
||
### 反馈举报核查
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/reportChecks/{reportCheckId}/feedback |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| reportCheckId | string | 举报核查ID |
|
||
| 请求体参数 | |
|
||
| feedback | string | 反馈内容 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "反馈成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 执法文书管理
|
||
|
||
### 分页查询文书信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/documents |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| pageNo | integer | 页码 |
|
||
| pageSize | integer | 每页记录数 |
|
||
| agencyId | string | 执法机构ID（可选） |
|
||
| documentType | string | 文书类型（可选） |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 文书信息列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"documentId": "ULID2001",
|
||
"documentName": "行政处罚告知书",
|
||
"documentType": "告知书"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 根据ID查询文书信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/documents/{documentId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| documentId | string | 文书ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 文书信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"documentId": "ULID2001",
|
||
"documentName": "行政处罚告知书",
|
||
"documentType": "告知书",
|
||
"contentUrl": "/files/doc/ULID2001.pdf"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 行政处罚流程
|
||
|
||
### 分页查询案件信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/cases |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| pageNo | integer | 页码 |
|
||
| pageSize | integer | 每页记录数 |
|
||
| agencyId | string | 执法机构ID（可选） |
|
||
| status | string | 案件状态（可选） |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 案件列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"caseId": "ULID3001",
|
||
"title": "危险化学品违规储存"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 查询案件信息（单条）
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/cases/{caseId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| caseId | string | 案件ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 案件信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"caseId": "ULID3001",
|
||
"title": "危险化学品违规储存",
|
||
"status": "调查中"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 查询案件信息（不分页）
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/cases/list |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| agencyId | string | 执法机构ID（可选） |
|
||
| status | string | 案件状态（可选） |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 案件列表 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"caseId": "ULID3001",
|
||
"title": "危险化学品违规储存"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 根据案件ID修改
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/cases/{caseId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| caseId | string | 案件ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| title | string | 案件标题 |
|
||
| caseNum | string | 案件编号 |
|
||
| enterpriseId | string | 企业ID |
|
||
| violationDesc | string | 违法行为描述 |
|
||
| status | string | 案件状态 |
|
||
| penaltyType | string | 处罚类型 |
|
||
| penaltyAmount | number | 罚款金额 |
|
||
| happenedDate | string | 发生日期(yyyy-MM-dd) |
|
||
| attachments | array<object> | 附件列表 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后案件 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"caseId": "ULID3001",
|
||
"status": "已立案"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 调查取证
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/cases/{caseId}/evidence |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| caseId | string | 案件ID |
|
||
| 请求体参数 | |
|
||
| evidenceUrls | array<string> | 证据文件路径数组 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "取证保存成功"
|
||
}
|
||
```
|
||
|
||
### 分析研判
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/cases/{caseId}/analysis |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| caseId | string | 案件ID |
|
||
| 请求体参数 | |
|
||
| analysis | string | 分析研判内容 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "分析研判成功"
|
||
}
|
||
```
|
||
|
||
### 生成案卷文件并下载
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/cases/{caseId}/download |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | application/octet-stream |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| caseId | string | 案件ID |
|
||
| 响应结果 | |
|
||
| application/octet-stream | 文件流 | 案卷压缩包 |
|
||
|
||
## 综合执法 / 执法信息
|
||
|
||
### 创建执法信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforcements |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| enterpriseId | string | 企业ID |
|
||
| agencyId | string | 执法机构ID |
|
||
| title | string | 执法主题 |
|
||
| planDate | string | 计划执法日期(yyyy-MM-dd) |
|
||
| description | string | 执法说明 |
|
||
| officerIds | array<string> | 执法人员ID列表 |
|
||
| attachments | array<object> | 附件列表 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后执法信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"enforcementId": "ULID4001",
|
||
"title": "安全检查"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询执法信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enforcementId | string | 执法信息ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 执法信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"enforcementId": "ULID4001",
|
||
"title": "安全检查",
|
||
"status": "草稿"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 更新执法信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enforcementId | string | 执法信息ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| enterpriseId | string | 企业ID |
|
||
| agencyId | string | 执法机构ID |
|
||
| title | string | 执法主题 |
|
||
| planDate | string | 计划执法日期(yyyy-MM-dd) |
|
||
| description | string | 执法说明 |
|
||
| officerIds | array<string> | 执法人员ID列表 |
|
||
| attachments | array<object> | 附件列表 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后执法信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"enforcementId": "ULID4001",
|
||
"status": "已提交"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除执法信息
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enforcementId | string | 执法信息ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
### 执法信息方案审批
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId}/approve |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enforcementId | string | 执法信息ID |
|
||
| 请求体参数 | |
|
||
| approval | string | 审批意见 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "审批成功"
|
||
}
|
||
```
|
||
|
||
### 执法信息总结
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId}/summary |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enforcementId | string | 执法信息ID |
|
||
| 请求体参数 | |
|
||
| summary | string | 总结内容 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "总结成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 监督检查（现场检查）
|
||
|
||
### 创建执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| enforcementId | string | 关联的执法信息ID |
|
||
| checkDate | string | 检查日期(yyyy-MM-dd) |
|
||
| checkPlace | string | 检查场所 |
|
||
| remark | string | 备注 |
|
||
| checkStatus | string | 检查状态（1.待检查 2.已检查） |
|
||
| checkResult | string | 检查结果 |
|
||
| rectificationDate | string | 整改完成日期(yyyy-MM-dd) |
|
||
| rectificationMeasures | string | 整改措施 |
|
||
| officerIds | array<string> | 执法人员ID列表 |
|
||
| checkType | string | 检查类型 |
|
||
| supplement | object | 检查补充内容 |
|
||
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后检查记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"inspectionId": "ULID5001",
|
||
"enforcementId": "ULID4001",
|
||
"checkDate": "2025-07-02"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| inspectionId | string | 检查记录ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 检查记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"inspectionId": "ULID5001",
|
||
"enforcementId": "ULID4001",
|
||
"status": "进行中"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 分页查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| pageNo | integer | 页码 |
|
||
| pageSize | integer | 每页记录数 |
|
||
| enforcementId | string | 执法信息ID（可选） |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 检查记录列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"inspectionId": "ULID5001",
|
||
"enforcementId": "ULID4001"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 更新执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| inspectionId | string | 检查记录ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| enforcementId | string | 关联的执法信息ID |
|
||
| checkDate | string | 检查日期(yyyy-MM-dd) |
|
||
| checkPlace | string | 检查场所 |
|
||
| remark | string | 备注 |
|
||
| checkStatus | string | 检查状态（1.待检查 2.已检查） |
|
||
| checkResult | string | 检查结果 |
|
||
| rectificationDate | string | 整改完成日期(yyyy-MM-dd) |
|
||
| rectificationMeasures | string | 整改措施 |
|
||
| officerIds | array<string> | 执法人员ID列表 |
|
||
| checkType | string | 检查类型 |
|
||
| supplement | object | 检查补充内容 |
|
||
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后检查记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"inspectionId": "ULID5001",
|
||
"status": "已完成"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| inspectionId | string | 检查记录ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 文书送达记录
|
||
|
||
### 创建文书送达记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-records |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| documentId | string | 文书ID |
|
||
| recipientId | string | 受送人ID |
|
||
| deliverMethodId | string | 送达方式ID |
|
||
| deliverDate | string | 送达日期(yyyy-MM-dd) |
|
||
| deliverAddress | string | 送达地址 |
|
||
| status | string | 送达状态（1.已送达 2.未送达） |
|
||
| remark | string | 备注 |
|
||
| attachments | array<object> | 送达附件列表 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"recordId": "ULID7001",
|
||
"documentId": "DOC123"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询文书送达记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-records/{recordId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| recordId | string | 送达记录ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 文书送达记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"recordId": "ULID7001",
|
||
"documentId": "DOC123",
|
||
"status": "1"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 分页查询文书送达记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-records |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| pageNo | integer | 页码 |
|
||
| pageSize | integer | 每页记录数 |
|
||
| status | string | 送达状态(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 送达记录列表 |
|
||
| total | integer | 总数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"recordId": "ULID7001",
|
||
"documentId": "DOC123"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 更新文书送达记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-records/{recordId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| recordId | string | 送达记录ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| deliverMethodId | string | 送达方式ID |
|
||
| deliverDate | string | 送达日期(yyyy-MM-dd) |
|
||
| deliverAddress | string | 送达地址 |
|
||
| status | string | 送达状态 |
|
||
| remark | string | 备注 |
|
||
| attachments | array<object> | 送达附件列表 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"recordId": "ULID7001",
|
||
"status": "1"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除文书送达记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-records/{recordId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| recordId | string | 送达记录ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 自动执法计划信息
|
||
|
||
### 创建自动执法计划
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/auto-enforce-plans |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| title | string | 计划名称 |
|
||
| cron | string | 执行Cron表达式 |
|
||
| targetAgencyIds | array<string> | 目标执法机构ID列表 |
|
||
| description | string | 计划说明 |
|
||
| enabled | boolean | 是否启用 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后计划 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"planId": "ULID6001",
|
||
"title": "季度安全检查计划"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询自动执法计划
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/auto-enforce-plans/{planId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| planId | string | 计划ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 自动执法计划 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"planId": "ULID6001",
|
||
"title": "季度安全检查计划",
|
||
"enabled": true
|
||
}
|
||
}
|
||
```
|
||
|
||
### 分页查询自动执法计划
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/auto-enforce-plans |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| pageNo | integer | 页码 |
|
||
| pageSize | integer | 每页记录数 |
|
||
| enabled | boolean | 是否启用(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 计划列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"planId": "ULID6001",
|
||
"title": "季度安全检查计划"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 更新自动执法计划
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/auto-enforce-plans/{planId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| planId | string | 计划ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| title | string | 计划名称 |
|
||
| cron | string | 执行Cron表达式 |
|
||
| targetAgencyIds | array<string> | 目标执法机构ID列表 |
|
||
| description | string | 计划说明 |
|
||
| enabled | boolean | 是否启用 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后计划 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"planId": "ULID6001",
|
||
"enabled": false
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除自动执法计划
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/auto-enforce-plans/{planId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| planId | string | 计划ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 文书送达方式
|
||
|
||
### 创建送达方式
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-methods |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| methodName | string | 送达方式名称 |
|
||
| description | string | 说明 |
|
||
| enabled | boolean | 是否启用 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"methodId": "ULID7101",
|
||
"methodName": "邮寄送达"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询送达方式
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-methods/{methodId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| methodId | string | 送达方式ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 送达方式 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"methodId": "ULID7101",
|
||
"methodName": "邮寄送达",
|
||
"enabled": true
|
||
}
|
||
}
|
||
```
|
||
|
||
### 分页查询送达方式
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-methods |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| pageNo | integer | 页码 |
|
||
| pageSize | integer | 每页记录数 |
|
||
| enabled | boolean | 是否启用(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 送达方式列表 |
|
||
| total | integer | 总数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"methodId": "ULID7101",
|
||
"methodName": "邮寄送达"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 更新送达方式
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-methods/{methodId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| methodId | string | 送达方式ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| methodName | string | 送达方式名称 |
|
||
| description | string | 说明 |
|
||
| enabled | boolean | 是否启用 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"methodId": "ULID7101",
|
||
"enabled": false
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除送达方式
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/delivery-methods/{methodId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| methodId | string | 送达方式ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 受送人管理
|
||
|
||
### 创建受送人
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/recipients |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| name | string | 受送人姓名 |
|
||
| phone | string | 联系电话 |
|
||
| address | string | 联系地址 |
|
||
| idNumber | string | 身份证号 |
|
||
| remark | string | 备注 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"recipientId": "ULID7201",
|
||
"name": "张三"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询受送人
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/recipients/{recipientId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| recipientId | string | 受送人ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 受送人信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"recipientId": "ULID7201",
|
||
"name": "张三",
|
||
"phone": "13800000000"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 分页查询受送人
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/recipients |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| pageNo | integer | 页码 |
|
||
| pageSize | integer | 每页记录数 |
|
||
| name | string | 姓名(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 受送人列表 |
|
||
| total | integer | 总数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"recipientId": "ULID7201",
|
||
"name": "张三"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 更新受送人
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/recipients/{recipientId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| recipientId | string | 受送人ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| name | string | 受送人姓名 |
|
||
| phone | string | 联系电话 |
|
||
| address | string | 联系地址 |
|
||
| idNumber | string | 身份证号 |
|
||
| remark | string | 备注 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"recipientId": "ULID7201",
|
||
"name": "李四"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除受送人
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/recipients/{recipientId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| recipientId | string | 受送人ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 检查事项
|
||
|
||
### 创建检查事项
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/check-items |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| itemName | string | 检查事项名称 |
|
||
| category | string | 所属类别 |
|
||
| basis | string | 法律依据 |
|
||
| enabled | boolean | 是否启用 |
|
||
| remark | string | 备注 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"checkItemId": "ULID7301",
|
||
"itemName": "安全生产制度落实情况"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询检查事项
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/check-items/{checkItemId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| checkItemId | string | 检查事项ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 检查事项信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"checkItemId": "ULID7301",
|
||
"itemName": "安全生产制度落实情况",
|
||
"enabled": true
|
||
}
|
||
}
|
||
```
|
||
|
||
### 分页查询检查事项
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/check-items |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 查询参数 | |
|
||
| pageNo | integer | 页码 |
|
||
| pageSize | integer | 每页记录数 |
|
||
| itemName | string | 事项名称(可选) |
|
||
| category | string | 类别(可选) |
|
||
| enabled | boolean | 是否启用(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 检查事项列表 |
|
||
| total | integer | 总数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"checkItemId": "ULID7301",
|
||
"itemName": "安全生产制度落实情况"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 更新检查事项
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/check-items/{checkItemId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| checkItemId | string | 检查事项ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| itemName | string | 检查事项名称 |
|
||
| category | string | 所属类别 |
|
||
| basis | string | 法律依据 |
|
||
| enabled | boolean | 是否启用 |
|
||
| remark | string | 备注 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"checkItemId": "ULID7301",
|
||
"enabled": false
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除检查事项
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/check-items/{checkItemId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| checkItemId | string | 检查事项ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 检查表
|
||
### 创建检查表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/checklists |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| checklistName | string | 检查表名称 |
|
||
| description | string | 描述 |
|
||
| enabled | boolean | 是否启用 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"checklistId": "ULID1001",
|
||
"checklistName": "企业安全检查表",
|
||
"enabled": true
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询检查表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/checklists/{checklistId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| checklistId | string | 检查表ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 检查表信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"checklistId": "ULID1001",
|
||
"checklistName": "企业安全检查表",
|
||
"description": "用于企业安全生产日常检查",
|
||
"enabled": true
|
||
}
|
||
}
|
||
```
|
||
|
||
### 查询检查表列表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/checklists/list |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| Query 参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| page | integer | 当前页 |
|
||
| pagesize | integer | 每页记录数 |
|
||
| checklistName | string | 检查表名称(可选) |
|
||
| enabled | boolean | 是否启用(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 检查表列表 |
|
||
| total | integer | 总数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"checklistId": "ULID1001",
|
||
"checklistName": "企业安全检查表",
|
||
"enabled": true
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 更新检查表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/checklists/{checklistId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| checklistId | string | 检查表ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| checklistName | string | 检查表名称 |
|
||
| description | string | 描述 |
|
||
| enabled | boolean | 是否启用 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
"checklistId": "ULID1001",
|
||
"enabled": false
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除检查表
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/checklists/{checklistId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| checklistId | string | 检查表ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 扫码入企
|
||
### 生成二维码
|
||
系统接口设计
|
||
| 请求地址 | /api/qrcode/generate |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求参数 | 无 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | string | 二维码信息(base64或URL) |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "操作成功",
|
||
"data": "https://example.com/qr/xxxxx"
|
||
}
|
||
```
|
||
|
||
### 校验二维码
|
||
系统接口设计
|
||
| 请求地址 | /api/qrcode/validate |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| Query 参数 | |
|
||
| 参数名称 | 类型 | 是否必填 | 说明 |
|
||
| -- | -- | -- | -- |
|
||
| token | string | 是 | 二维码token |
|
||
| enforcementId | string | 是 | 企业ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 校验结果 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "校验成功",
|
||
"data": {
|
||
"valid": true,
|
||
"enterpriseName": "西安应急有限公司"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 检查二维码状态
|
||
系统接口设计
|
||
| 请求地址 | /api/qrcode/check-status |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| Query 参数 | |
|
||
| 参数名称 | 类型 | 是否必填 | 说明 |
|
||
| -- | -- | -- | -- |
|
||
| token | string | 是 | 二维码token |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | string | 状态信息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": "已使用"
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 法制审核
|
||
|
||
### 根据ID查询执法信息
|
||
系统接口设计
|
||
| 请求地址 | /api/legal-review/{enforcementId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| enforcementId | string | 执法信息ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 执法信息详情 |
|
||
| ├ enforcementId | string | 执法信息ID |
|
||
| ├ enterprise | object | 企业信息 |
|
||
| ├ agency | object | 执法机构信息 |
|
||
| ├ status | string | 当前状态 |
|
||
| ├ createTime | string | 创建时间 |
|
||
| ├ updateTime | string | 更新时间 |
|
||
| └ attachments | array<object> | 附件列表 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": {
|
||
"enforcementId": "ULID4001",
|
||
"enterprise": { "unitName": "西安示例化工有限公司" },
|
||
"agency": { "agencyName": "高新区应急局" },
|
||
"status": "draft",
|
||
"createTime": "2025-07-01T09:00:00",
|
||
"updateTime": "2025-07-01T09:00:00",
|
||
"attachments": []
|
||
}
|
||
}
|
||
```
|
||
|
||
### 查询执法信息
|
||
系统接口设计
|
||
| 请求地址 | /api/legal-review/info |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| Query 参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| page | integer | 当前页 |
|
||
| pagesize | integer | 每页记录数 |
|
||
| enterpriseName | string | 企业名称(可选) |
|
||
| status | string | 状态(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 执法信息列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"enforcementId": "ULID4001",
|
||
"enterpriseName": "西安示例化工有限公司",
|
||
"status": "pending",
|
||
"createTime": "2025-07-01T09:00:00"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 法制审核
|
||
系统接口设计
|
||
| 请求地址 | /api/legal-review/audit |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| enforcementId | string | 执法信息ID |
|
||
| auditResult | string | 审核结果(approve / reject) |
|
||
| auditOpinion | string | 审核意见 |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 审核结果 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "审核完成",
|
||
"data": {
|
||
"enforcementId": "ULID4001",
|
||
"auditResult": "approved"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 新增调查报告
|
||
系统接口设计
|
||
| 请求地址 | /api/legal-review |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| enforcementId | string | 执法信息ID |
|
||
| title | string | 报告标题 |
|
||
| content | string | 报告内容 |
|
||
| attachments | array<object> | 附件列表(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建结果 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "新增成功",
|
||
"data": {
|
||
"reportId": "ULID5002",
|
||
"enforcementId": "ULID4001"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 综合执法 / 执法信息现场检查
|
||
|
||
### 创建执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| enforcementId | string | 执法信息ID |
|
||
| checkDate | string | 检查日期(yyyy-MM-dd) |
|
||
| checkPlace | string | 检查地点 |
|
||
| remark | string | 备注 |
|
||
| officerIds | array<string> | 执法人ID列表 |
|
||
| checkType | string | 检查类型代码 |
|
||
| attachments | array<object> | 附件列表(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "创建成功",
|
||
"data": {
|
||
"inspectionId": "ULID6001",
|
||
"enforcementId": "ULID4001"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| inspectionId | string | 检查记录ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 检查记录详情 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": {
|
||
"inspectionId": "ULID6001",
|
||
"enforcementId": "ULID4001",
|
||
"checkDate": "2025-07-02",
|
||
"checkPlace": "企业A生产车间"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 分页查询执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| Query 参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| page | integer | 当前页 |
|
||
| pagesize | integer | 每页记录数 |
|
||
| enforcementId | string | 执法信息ID(可选) |
|
||
| checkDate | array<string> | 检查日期范围(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 检查记录列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"inspectionId": "ULID6001",
|
||
"enforcementId": "ULID4001",
|
||
"checkDate": "2025-07-02"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 更新执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| inspectionId | string | 检查记录ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| checkDate | string | 检查日期(yyyy-MM-dd) |
|
||
| checkPlace | string | 检查地点 |
|
||
| remark | string | 备注 |
|
||
| checkStatus | string | 检查状态(1.待检查 2.已检查) |
|
||
| checkResult | string | 检查结果代码 |
|
||
| rectificationDate | string | 整改完成日期(yyyy-MM-dd) |
|
||
| rectificationMeasures | string | 整改措施 |
|
||
| officerIds | array<string> | 执法人ID列表 |
|
||
| attachments | array<object> | 附件列表(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后记录 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "更新成功",
|
||
"data": {
|
||
"inspectionId": "ULID6001",
|
||
"checkStatus": "2"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据ID删除执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
|
||
| -- | -- |
|
||
| 请求方式 | DELETE |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| inspectionId | string | 检查记录ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "删除成功"
|
||
}
|
||
```
|
||
### 分页查询历史执法检查记录
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/history |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| Query 参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| page | integer | 当前页 |
|
||
| pagesize | integer | 每页记录数 |
|
||
| enforcementId | string | 执法信息ID(可选) |
|
||
| officerId | string | 执法人ID(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 历史检查记录列表 |
|
||
| total | integer | 总记录数 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"inspectionId": "ULID6000",
|
||
"enforcementId": "ULID3999",
|
||
"checkDate": "2024-06-30"
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 添加抽样数据
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId}/samples |
|
||
| -- | -- |
|
||
| 请求方式 | POST |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| inspectionId | string | 检查记录ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| sampleCode | string | 样品编码 |
|
||
| sampleName | string | 样品名称 |
|
||
| sampleNumber | integer | 样品数量 |
|
||
| unit | string | 计量单位 |
|
||
| remark | string | 备注(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 创建后抽样数据 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "新增成功",
|
||
"data": {
|
||
"sampleId": "ULID7001",
|
||
"inspectionId": "ULID6001"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 修改抽样数据
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId}/samples/{sampleId} |
|
||
| -- | -- |
|
||
| 请求方式 | PUT |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| inspectionId | string | 检查记录ID |
|
||
| sampleId | string | 抽样数据ID |
|
||
| 请求体参数 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| sampleNumber | integer | 样品数量 |
|
||
| remark | string | 备注(可选) |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | object | 更新后抽样数据 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "更新成功",
|
||
"data": {
|
||
"sampleId": "ULID7001",
|
||
"sampleNumber": 5
|
||
}
|
||
}
|
||
```
|
||
|
||
### 根据执法信息ID查询抽样数据
|
||
系统接口设计
|
||
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId}/samples |
|
||
| -- | -- |
|
||
| 请求方式 | GET |
|
||
| 认证方式 | Bearer Auth |
|
||
| 响应格式 | json |
|
||
| 请求头参数 | |
|
||
| Authorization | access_token |
|
||
| 路径参数 | |
|
||
| inspectionId | string | 检查记录ID |
|
||
| 响应结果 | |
|
||
| 参数名称 | 类型 | 说明 |
|
||
| -- | -- | -- |
|
||
| code | integer | 状态码 |
|
||
| success | boolean | 是否成功 |
|
||
| msg | string | 消息 |
|
||
| data | array<object> | 抽样数据列表 |
|
||
| 返回示例 | |
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"success": true,
|
||
"msg": "查询成功",
|
||
"data": [
|
||
{
|
||
"sampleId": "ULID7001",
|
||
"sampleName": "水样",
|
||
"sampleNumber": 3,
|
||
"unit": "瓶"
|
||
}
|
||
]
|
||
}
|
||
```
|