节点验收保存或新增
接口地址:/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
最后编辑:liangxiong 更新时间:2026-01-29 21:49