zhzf/server/documents/接口设计书.md

4569 lines
112 KiB
Markdown
Raw Normal View History

2025-02-28 16:49:05 +08:00
# 西安应急综合执法
## 接口对接/提供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 | 执法机构唯一IDULID |
| ├ `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": "瓶"
}
]
}
```