节点验收保存或新增

接口地址:/openapi/projectStepAcceptance/saveOrUpdate

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
    "projectId": 1663753170050707457,
    "nodeName": "节点名称",
    "imgAndVideoUrl": "[{\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/face/1429990294122340353/202304/0995012c-3b67-451e-8c95-ef7e3d3edc55.jpg\", \"type\": \"image\"}]",
    "userId": 1390577488135925762,
    "mobile": "13012345678",
    "createTimeStr": null
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 备注
id 记录ID body false long 修改的时候传递
projectId 工地ID body true long
nodeName 节点名称 body true string 节点名称, 通过施工节点管理相关接口获取
imgAndVideoUrl 图片或视频地址 body true string json数组字符串, type可以是image或者video
userId 操作人ID body false long
mobile 操作人手机号码 body false string 比如: 工地主要负责人手机号码
content 验收文本内容 body false string 验收文本内容
createTimeStr 人为指定创建时间字符串 body false string 可能为空, 格式为yyyy-MM-dd或yyyy-MM-dd HH:mm:ss

参数说明

1. imgAndVideoUrl 图片或视频地址是`json`字符串类型
2. createTimeStr 人为指定数据创建时间, 格式为yyyy-MM-dd或yyyy-MM-dd HH:mm:ss, 比如2023-07-01;
3. userId 和 mobile 不能同时为空;
4. nodeName, 施工节点名称中文; 通过施工节点管理相关接口获取;

响应参数:

参数名称 参数说明 类型 格式
记录ID long

删除节点验收记录

接口地址:/openapi/projectStepAcceptance/deleteById?id=xxx

请求方式:DELETE

请求数据类型:query parameter

响应数据类型:*/*

接口描述:

请求示例:

路径携带参数?id=xxx

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 默认值
id 节点验收记录id query param true long

参数说明

响应参数:

参数名称 参数说明 类型 格式
删除成功状态 boolean

节点验收记录分页查询

接口地址:/openapi/projectStepAcceptance/page?pageNo=1&pageSize=10

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
    "projectId": 1677158820885663746
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 默认值
projectId 工地ID, 必填项 body true true

参数说明


1. projectId 工地ID;

响应参数:

参数名称 参数说明 类型 格式
id 验收记录ID long
nodeId 施工节点ID long
criteriaId 验收标准ID long
projectId 工地ID long
content 工地动态内容 string
positionId 节点验收人岗位ID long
positionName 节点验收人岗位名称 string
imgAndVideoUrl 图片或视频地址 string
createdBy 节点验收人ID long
creatorName 节点验收人姓名 string
createdTime 添加日期 string yyyy-MM-dd
modifiedTime 修改日期 string yyyy-MM-dd

节点验收明细分页查询

接口地址:/openapi/projectStepAcceptance/pageProjectAcceptance?pageNo=1&pageSize=10

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

接口返回了工地相关节点的验收状态和数据, 接口默认根据工地排序

请求示例:

{
    "projectId": 1677158820885663723,
    "acceptanceCommentTypeList": [
        "BAD",
        "GOOD",
        "NO_STAR"
    ],
    "acceptanceStatusList": [
        "ING",
        "BEEN",
        "NOT"
    ],
    "orgId": "1363692883161612290",
    "userId": "1932360296375037953",
    "startDate": "2025-06-10",
     "endDate": "2025-06-10"

}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 备注
projectId 工地ID body false long
acceptanceCommentTypeList 业主评分, 集合表示多选 body false list
acceptanceStatusList 验收状态,集合表示多选 body false list
orgId 公司ID,筛选工地范围 body false long
userId 验收人ID body false long
startDate 验收时间下限 body false string 格式: yyyy-MM-dd
endDate 验收时间上限 body false string 格式: yyyy-MM-dd

参数说明

1. 评分过滤参数 acceptanceCommentTypeList
1.1 "BAD", 差评;
1.2 "GOOD", 好评;
1.3 "NO_STAR", 未评价;

2.验收状态过滤参数 acceptanceStatusList
2.1 "ING", 验收中;
2.2 "BEEN", 已验收;
2.3 "NOT", 未验收;
2.4 "WAIT", 待审核(备注: 需要WEB端个性化功能<验收记录审批>开关打开);
2.5 "REVISE", 待整改(备注: 需要WEB端个性化功能<验收记录审批>开关打开);

响应示例

{
    "code": 200,
    "message": "成功",
    "data": {
        "records": [
            {
                "id": "1932963440130596865",
                "projectId": "1927586103075627010",
                "projectName": "金科6栋16-1",
                "companyName": "仁怀典范",
                "deptName": "仁怀工程二部",
                "managerName": null,
                "supervisorName": "何园园",
                "projectStatusDesc": "在建",
                "buildDays": "10",
                "remainDays": "95",
                "stageName": "泥工工程",
                "nodeName": "米字形排水槽",
                "acceptanceStatusDesc": "已验收",
                "userName": "何园园",
                "userId": "1915593602138931201",
                "createdTime": "2025-06-12 08:49:32",
                "imgAndVideoUrl": "[{\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202506/1ed4f152-603d-49c3-9653-b7973d762edc.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202506/311811c8-f496-4ab2-b3d0-5ee0bdfdafd9.jpg\", \"type\": \"image\"}]",
                "totalStar": null,
                "comment": null,
                "commentDate": null,
                "planStartDate": "2025-01-01",
                "planEndDate": "2025-05-05"

            },
            {
                "id": "1932634374806437890",
                "projectId": "1929854103354867714",
                "projectName": "国际公馆1-2-19-2尹丹丹",
                "companyName": "遵义典范",
                "deptName": "工程六部",
                "managerName": null,
                "supervisorName": "陈松松",
                "projectStatusDesc": "在建",
                "buildDays": "7",
                "remainDays": "113",
                "stageName": "水电工程",
                "nodeName": "水路打压测试",
                "acceptanceStatusDesc": "已验收",
                "userName": "陈松松",
                "userId": "1915593602138931201",
                "createdTime": "2025-06-11 11:01:56",
                "imgAndVideoUrl": "[{\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202506/8382d7aa-8a09-464d-bb3c-1fce995fba86.jpg\", \"type\": \"image\"}]",
                "totalStar": null,
                "comment": null,
                "commentDate": null,
                "planStartDate": "2025-01-01",
                "planEndDate": "2025-05-05"

            }
        ],
        "total": "100",
        "size": "10",
        "current": "1",
        "orders": [],
        "optimizeCountSql": true,
        "hitCount": false,
        "countId": null,
        "maxLimit": null,
        "searchCount": true,
        "pages": "10"
    },
    "successful": true
}

响应参数说明

参数名称 参数说明 类型 备注
id 验收记录ID long 如果当前节点未验收,则值为空
projectId 工地ID long
projectName 工地名称 string
companyName 工地所属公司名称 string
deptName 工地所属部门名称, 可能为空 string
supervisorName 主要负责人姓名 string
managerName 次要负责人姓名 string
projectStatusDesc 工地状态 string
buildDays 施工天数 integer
remainDays 剩余工期天数 integer
stageName 施工阶段 string
nodeName 施工节点 string
acceptanceStatusDesc 验收状态 string
userName 验收人姓名 string
createdTime 验收时间 string 格式: yyyy-MM-dd HH:mm:ss
imgAndVideoUrl 图片或视频地址, JSON数组字符串表示 string
totalStar 业主评分 string
comment 评价内容 string
commentDate 评价日期 string 格式: yyyy-MM-dd HH:mm:ss
planStartDate 计划开工时间 string 格式: yyyy-MM-dd
planEndDate 计划完工时间 string 格式: yyyy-MM-dd
作者:admin  创建时间:2023-07-18 16:24
最后编辑:liangxiong  更新时间:2026-01-29 21:49