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

西安应急综合执法

接口对接/提供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
├ agencyId	string
├ agencyName	string
├ agencyCode	string
├ agencySimpleCode	string
├ agencyLevel	integer
├ leaf	boolean
├ orderNum	integer
├ agencyPath	string
├ parent	object
└ children	array
返回示例

{
  "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
agencyCode	string
agencyName	string
parentId	string
agencyLevel	string
contactPhone	string
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	array
total	integer
page	integer
limit	integer
totalPages	integer
relation	string
返回示例

{
  "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
agencyCode	string
agencyName	string
parentId	string
agencyLevel	string
contactPhone	string
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	array
返回示例

{
  "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
agencyCode	string
unitName	string
startTime	string
endTime	string
currentNodeCode	string
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	array
├ enforcementId	string
├ enterpriseId	string
├ enterprise	object
├ agencyId	string
├ agency	object
├ examineReportId	string
├ examineReport	object
├ currentNodeCode	string
├ currentNode	string
├ createTime	string
├ updateTime	string
├ enforceChecks	array
├ checkItems	array
└ caseInfo	object
total	integer
page	integer
limit	integer
totalPages	integer
返回示例

{
  "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
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	object
├ enforcementId	string
├ enterpriseId	string
├ enterprise	object
├ agencyId	string
├ agency	object
├ examineReportId	string
├ examineReport	object
├ currentNodeCode	string
├ currentNode	string
├ createTime	string
├ updateTime	string
├ enforceChecks	array
├ checkItems	array
└ caseInfo	object
返回示例

{
  "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
caseClosingDate	array
archiveDate	array
status	string
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	array
total	integer
page	integer
limit	integer
totalPages	integer
返回示例

{
  "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
├ caseNum	string
├ caseName	string
├ caseCause	string
├ disposition	string
├ enterpriseId	string
├ filedUserName	string
├ filedUserId	string
├ fillingDate	string
├ caseClosingDate	string
├ caseHandler	string
├ archiveDate	string
├ caseSource	string
├ archivalNum	string
├ shelfLife	integer
├ createdTime	string
├ updatedTime	string
├ status	string
├ enforcementId	string
├ enforcementInfo	object
└ documents	array
返回示例

{
  "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
documentNo	integer
caseName	string
caseNum	string
documentCode	integer
documentName	string
documentDate	array
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	array
├ documentId	string
├ documentCode	string
├ documentNo	integer
├ documentName	string
├ documentType	string
├ documentDate	string
├ filePath	string
├ fileName	string
├ caseId	string
├ caseInfo	object
├ status	string
└ downloadUrl	string
total	integer
page	integer
limit	integer
totalPages	integer
返回示例

{
  "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
documentName	string
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	object
├ documentId	string
├ documentCode	string
├ documentNo	integer
├ documentName	string
├ documentType	string
├ documentDate	string
├ documenContent	object
├ filePath	string
├ fileName	string
├ caseId	string
├ caseInfo	object
├ status	string
└ downloadUrl	string
返回示例

{
  "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
enterpriseId	string
checkDate	array
createTime	array
supplementVerifyResult	string
period	string
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	array
├ enforceCheckId	string
├ 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
返回示例

{
  "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
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	object
├ enforceCheckId	string
├ 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
返回示例

{
  "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 | 总页数 | | 返回示例 | |

{
  "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
checkDate	string
checkPlace	string
remark	string
checkStatus	string
checkResult	string
rectificationDate	string
rectificationMeasures	string
officerIds	string
checkType	string
supplement	object
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
enterpriseId	string
checkDate	array
createTime	array
supplementVerifyResult	string
tag	string
响应结果
参数名称	类型
code	integer
success	boolean
msg	string
data	array
total	integer
page	integer
limit	integer
totalPages	integer
返回示例

{
  "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
返回示例

{
  "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
返回示例

{
  "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
返回示例

{
  "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
返回示例

{
  "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
返回示例

{
  "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
返回示例

{
  "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
返回示例

{
  "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
返回示例

{
  "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
返回示例

{
  "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
请求体参数
无
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
请求体参数
Agency	执法机构对象
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
请求体参数
无
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	null
返回示例

{
  "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
agencyLevel	string
请求体参数
无
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
返回示例

{
  "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
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "officerId": "ULID456",
      "officerName": "张三"
    }
  ]
}

更新执法人员

系统接口设计

请求地址	/api/lawenforcement/officers/{officerId}
请求方式	PUT
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
officerId	string
请求体参数
Officer	执法人员对象
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
enterpriseId	string
checkDate	array
sort	string
dir	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
total	integer
返回示例

{
  "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
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
请求体参数
Enterprise	企业信息对象
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}

查询企业信息列表

系统接口设计

请求地址	/api/lawenforcement/enterprises
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
查询参数
page	integer
pagesize	integer
unitName	string
agencyId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
total	integer
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "enterpriseId": "ULID901",
      "unitName": "西安示例化工有限公司"
    }
  ],
  "total": 1
}

企业信息统计

系统接口设计

请求地址	/api/lawenforcement/enterprises/statistics
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
查询参数
agencyId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
├ total	integer
└ byAgency	array
返回示例

{
  "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
unitName	string
响应结果	文件流

批量导入企业信息(importFile)

系统接口设计

请求地址	/api/lawenforcement/enterprises/importFile
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
请求体参数
file	file
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "导入成功"
}

根据机构查询企业列表

系统接口设计

请求地址	/api/lawenforcement/enterprises/agency/{agencyId}
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
agencyId	string
查询参数
page	integer
pagesize	integer
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
total	integer
返回示例

{
  "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
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
查询参数
page	integer
pagesize	integer
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
total	integer
返回示例

{
  "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
请求体参数
Complaint	投诉举报对象
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "complaintId": "ULID1001",
    "status": "已处理"
  }
}

根据ID删除投诉举报

系统接口设计

请求地址	/api/lawenforcement/complaints/{complaintId}
请求方式	DELETE
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
complaintId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}

综合执法 / 举报核查管理

创建举报核查信息

系统接口设计

请求地址	/api/lawenforcement/reportChecks
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
请求体参数
ReportCheck	举报核查对象
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "reportCheckId": "ULID1101",
    "complaintId": "ULID1001",
    "status": "待核查"
  }
}

更新举报核查信息

系统接口设计

请求地址	/api/lawenforcement/reportChecks/{reportCheckId}
请求方式	PUT
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
reportCheckId	string
请求体参数
ReportCheck	举报核查对象
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "reportCheckId": "ULID1101",
    "status": "已核查"
  }
}

转交举报核查

系统接口设计

请求地址	/api/lawenforcement/reportChecks/{reportCheckId}/transfer
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
reportCheckId	string
请求体参数
targetAgencyId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "转交成功"
}

反馈举报核查

系统接口设计

请求地址	/api/lawenforcement/reportChecks/{reportCheckId}/feedback
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
reportCheckId	string
请求体参数
feedback	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "反馈成功"
}

综合执法 / 执法文书管理

分页查询文书信息

系统接口设计

请求地址	/api/lawenforcement/documents
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
查询参数
pageNo	integer
pageSize	integer
agencyId	string
documentType	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
total	integer
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
status	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
total	integer
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "caseId": "ULID3001",
      "title": "危险化学品违规储存"
    }
  ],
  "total": 1
}

查询案件信息（单条）

系统接口设计

请求地址	/api/lawenforcement/cases/{caseId}
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
caseId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "caseId": "ULID3001",
    "title": "危险化学品违规储存",
    "status": "调查中"
  }
}

查询案件信息（不分页）

系统接口设计

请求地址	/api/lawenforcement/cases/list
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
查询参数
agencyId	string
status	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "caseId": "ULID3001",
      "title": "危险化学品违规储存"
    }
  ]
}

根据案件ID修改

系统接口设计

请求地址	/api/lawenforcement/cases/{caseId}
请求方式	PUT
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
caseId	string
请求体参数
参数名称	类型
--	--
title	string
caseNum	string
enterpriseId	string
violationDesc	string
status	string
penaltyType	string
penaltyAmount	number
happenedDate	string
attachments	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "caseId": "ULID3001",
    "status": "已立案"
  }
}

调查取证

系统接口设计

请求地址	/api/lawenforcement/cases/{caseId}/evidence
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
caseId	string
请求体参数
evidenceUrls	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "取证保存成功"
}

分析研判

系统接口设计

请求地址	/api/lawenforcement/cases/{caseId}/analysis
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
caseId	string
请求体参数
analysis	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "分析研判成功"
}

生成案卷文件并下载

系统接口设计

请求地址	/api/lawenforcement/cases/{caseId}/download
请求方式	GET
认证方式	Bearer Auth
响应格式	application/octet-stream
请求头参数
Authorization	access_token
路径参数
caseId	string
响应结果
application/octet-stream	文件流

综合执法 / 执法信息

创建执法信息

系统接口设计

请求地址	/api/lawenforcement/enforcements
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
请求体参数
参数名称	类型
--	--
enterpriseId	string
agencyId	string
title	string
planDate	string
description	string
officerIds	array
attachments	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enforcementId": "ULID4001",
    "title": "安全检查"
  }
}

根据ID查询执法信息

系统接口设计

请求地址	/api/lawenforcement/enforcements/{enforcementId}
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
enforcementId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enforcementId": "ULID4001",
    "title": "安全检查",
    "status": "草稿"
  }
}

更新执法信息

系统接口设计

请求地址	/api/lawenforcement/enforcements/{enforcementId}
请求方式	PUT
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
enforcementId	string
请求体参数
参数名称	类型
--	--
enterpriseId	string
agencyId	string
title	string
planDate	string
description	string
officerIds	array
attachments	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enforcementId": "ULID4001",
    "status": "已提交"
  }
}

根据ID删除执法信息

系统接口设计

请求地址	/api/lawenforcement/enforcements/{enforcementId}
请求方式	DELETE
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
enforcementId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}

执法信息方案审批

系统接口设计

请求地址	/api/lawenforcement/enforcements/{enforcementId}/approve
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
enforcementId	string
请求体参数
approval	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "审批成功"
}

执法信息总结

系统接口设计

请求地址	/api/lawenforcement/enforcements/{enforcementId}/summary
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
enforcementId	string
请求体参数
summary	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "总结成功"
}

综合执法 / 监督检查（现场检查）

创建执法检查记录

系统接口设计

请求地址	/api/lawenforcement/site-inspections
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
请求体参数
参数名称	类型
--	--
enforcementId	string
checkDate	string
checkPlace	string
remark	string
checkStatus	string
checkResult	string
rectificationDate	string
rectificationMeasures	string
officerIds	array
checkType	string
supplement	object

| 响应结果 | |

参数名称	类型	说明
code	integer	状态码
success	boolean	是否成功
msg	string	消息
data	object	创建后检查记录
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
total	integer
返回示例

{
  "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
请求体参数
参数名称	类型
--	--
enforcementId	string
checkDate	string
checkPlace	string
remark	string
checkStatus	string
checkResult	string
rectificationDate	string
rectificationMeasures	string
officerIds	array
checkType	string
supplement	object

| 响应结果 | |

参数名称	类型	说明
code	integer	状态码
success	boolean	是否成功
msg	string	消息
data	object	更新后检查记录
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "inspectionId": "ULID5001",
    "status": "已完成"
  }
}

根据ID删除执法检查记录

系统接口设计

请求地址	/api/lawenforcement/site-inspections/{inspectionId}
请求方式	DELETE
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
inspectionId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}

综合执法 / 文书送达记录

创建文书送达记录

系统接口设计

请求地址	/api/lawenforcement/delivery-records
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
请求体参数
参数名称	类型
--	--
documentId	string
recipientId	string
deliverMethodId	string
deliverDate	string
deliverAddress	string
status	string
remark	string
attachments	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
total	integer
返回示例

{
  "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
请求体参数
参数名称	类型
--	--
deliverMethodId	string
deliverDate	string
deliverAddress	string
status	string
remark	string
attachments	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}

综合执法 / 自动执法计划信息

创建自动执法计划

系统接口设计

请求地址	/api/lawenforcement/auto-enforce-plans
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
请求体参数
参数名称	类型
--	--
title	string
cron	string
targetAgencyIds	array
description	string
enabled	boolean
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
total	integer
返回示例

{
  "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
请求体参数
参数名称	类型
--	--
title	string
cron	string
targetAgencyIds	array
description	string
enabled	boolean
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "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
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "methodId": "ULID7101",
    "methodName": "邮寄送达"
  }
}

根据ID查询送达方式

系统接口设计

请求地址	/api/lawenforcement/delivery-methods/{methodId}
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
methodId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
total	integer
返回示例

{
  "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
请求体参数
参数名称	类型
--	--
methodName	string
description	string
enabled	boolean
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "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
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "recipientId": "ULID7201",
    "name": "张三"
  }
}

根据ID查询受送人

系统接口设计

请求地址	/api/lawenforcement/recipients/{recipientId}
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
recipientId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
total	integer
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "recipientId": "ULID7201",
      "name": "张三"
    }
  ],
  "total": 1
}

更新受送人

系统接口设计

请求地址	/api/lawenforcement/recipients/{recipientId}
请求方式	PUT
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
recipientId	string
请求体参数
参数名称	类型
--	--
name	string
phone	string
address	string
idNumber	string
remark	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "recipientId": "ULID7201",
    "name": "李四"
  }
}

根据ID删除受送人

系统接口设计

请求地址	/api/lawenforcement/recipients/{recipientId}
请求方式	DELETE
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
recipientId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "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
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "checkItemId": "ULID7301",
    "itemName": "安全生产制度落实情况"
  }
}

根据ID查询检查事项

系统接口设计

请求地址	/api/lawenforcement/check-items/{checkItemId}
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
checkItemId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
total	integer
返回示例

{
  "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
请求体参数
参数名称	类型
--	--
itemName	string
category	string
basis	string
enabled	boolean
remark	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "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
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
total	integer
返回示例

{
  "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
请求体参数
参数名称	类型
--	--
checklistName	string
description	string
enabled	boolean
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "checklistId": "ULID1001",
    "enabled": false
  }
}

根据ID删除检查表

系统接口设计

请求地址	/api/lawenforcement/checklists/{checklistId}
请求方式	DELETE
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
checklistId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}

综合执法 / 扫码入企

生成二维码

系统接口设计

请求地址	/api/qrcode/generate
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
请求参数	无
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": "https://example.com/qr/xxxxx"
}

校验二维码

系统接口设计

请求地址	/api/qrcode/validate
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
Query 参数
参数名称	类型
--	--
token	string
enforcementId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "校验成功",
  "data": {
    "valid": true,
    "enterpriseName": "西安应急有限公司"
  }
}

检查二维码状态

系统接口设计

请求地址	/api/qrcode/check-status
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
Query 参数
参数名称	类型
--	--
token	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": "已使用"
}

综合执法 / 法制审核

根据ID查询执法信息

系统接口设计

请求地址	/api/legal-review/{enforcementId}
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
路径参数
enforcementId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
├ enforcementId	string
├ enterprise	object
├ agency	object
├ status	string
├ createTime	string
├ updateTime	string
└ attachments	array
返回示例

{
  "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
total	integer
返回示例

{
  "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
auditResult	string
auditOpinion	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "审核完成",
  "data": {
    "enforcementId": "ULID4001",
    "auditResult": "approved"
  }
}

新增调查报告

系统接口设计

请求地址	/api/legal-review
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
请求体参数
参数名称	类型
--	--
enforcementId	string
title	string
content	string
attachments	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "code": 0,
  "success": true,
  "msg": "新增成功",
  "data": {
    "reportId": "ULID5002",
    "enforcementId": "ULID4001"
  }
}

综合执法 / 执法信息现场检查

创建执法检查记录

系统接口设计

请求地址	/api/lawenforcement/site-inspections
请求方式	POST
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
请求体参数
参数名称	类型
--	--
enforcementId	string
checkDate	string
checkPlace	string
remark	string
officerIds	array
checkType	string
attachments	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
checkDate	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
total	integer
返回示例

{
  "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
请求体参数
参数名称	类型
--	--
checkDate	string
checkPlace	string
remark	string
checkStatus	string
checkResult	string
rectificationDate	string
rectificationMeasures	string
officerIds	array
attachments	array
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
返回示例

{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}

分页查询历史执法检查记录

系统接口设计

请求地址	/api/lawenforcement/site-inspections/history
请求方式	GET
认证方式	Bearer Auth
响应格式	json
请求头参数
Authorization	access_token
Query 参数
参数名称	类型
--	--
page	integer
pagesize	integer
enforcementId	string
officerId	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
total	integer
返回示例

{
  "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
请求体参数
参数名称	类型
--	--
sampleCode	string
sampleName	string
sampleNumber	integer
unit	string
remark	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
sampleId	string
请求体参数
参数名称	类型
--	--
sampleNumber	integer
remark	string
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	object
返回示例

{
  "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
响应结果
参数名称	类型
--	--
code	integer
success	boolean
msg	string
data	array
返回示例

{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "sampleId": "ULID7001",
      "sampleName": "水样",
      "sampleNumber": 3,
      "unit": "瓶"
    }
  ]
}