工地动态保存或新增
接口地址:/openapi/projectActivity/saveOrUpdate
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"projectId": 1663753170050707457,
"nodeName": "节点名称",
"content": "“水电无小事,责任大于天”,无论哪种工艺,都只为点亮万家灯火,表面的工程是工作,隐蔽的工程是良心,用心服务,不负信任。",
"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 | 节点名称, 通过施工节点管理相关接口获取 |
| content | 工地动态文本内容 | body | false | string | |
| imgAndVideoUrl | 图片或视频地址 | body | false | string | json数组字符串, type可以是image或者video |
| userId | 操作人ID | body | false | long | |
| mobile | 操作人手机号码 | 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/projectActivity/deleteById?id=xxx
请求方式:DELETE
请求数据类型:query parameter
响应数据类型:*/*
接口描述:
请求示例:
路径携带参数?id=xxx请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 默认值 |
|---|---|---|---|---|---|
| id | 工地动态id | query param | true | long |
参数说明
无
响应参数:
| 参数名称 | 参数说明 | 类型 | 格式 |
|---|---|---|---|
| 无 | 删除成功状态 | boolean |
工地动态明细分页查询
接口地址:/openapi/projectActivity/pageProjectActivity?pageNo=1&pageSize=10
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
接口返回了工地动态数据, 接口默认根据动态发布时间降序返回
请求示例:
{
"projectId": 1677158820885663723,
"projectName": "测试工地",
"userId": "1932360296375037953",
"startDate": "2025-06-10",
"endDate": "2025-06-10"
}请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|---|---|---|---|---|---|
| projectId | 工地ID | body | false | long | |
| projectName | 工地名称 | body | false | long | |
| userId | 发布人ID | body | false | long | |
| startDate | 发布时间开始条件 | body | false | string | 格式: yyyy-MM-dd |
| endDate | 发布时间结束条件 | body | false | string | 格式: yyyy-MM-dd |
参数说明
startDate和endDate格式都是yyyy-MM-dd ;
举例说明
startDate: 2026-01-01 服务器按照 "2026-01-01 00:00:00"过滤数据
endDate: 2026-01-10 服务器按照 "2026-01-10 23:59:59"过滤数据响应示例
{
"code": 200,
"message": "成功",
"data": {
"records": [
{
"id": "2011727332134199297",
"projectId": "2009820736319754242",
"userName": "用户名称",
"userId": "1639089163494039554",
"positionId": "1638055156098596865",
"positionName": "岗位名称",
"stageName": "拆改工程",
"content": "今日已提醒师傅下班后关闭水电,请您放心,谢谢。",
"imgUrls": null,
"videoUrls": null,
"imgAndVideoUrl": "[{\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/ebcaa793-4b5a-4198-86d4-40d2020779a2.mp4\", \"type\": \"video\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/f67ec0ee-15bc-4091-bb0c-097bbbb8e495.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/afd85b13-dc11-445e-bac6-bdedbbbd7777.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/d41831a2-4327-4416-8c38-afc244b0ec9e.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/78feacf4-0e24-492e-95e3-583ed93c7e18.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/a4c9f9a4-9038-42ad-b0e5-495d63dafff6.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/814da40a-aaf5-4f7c-9ca6-b3ece60f1f6e.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/299529b8-ce87-4b80-8d6d-33ffe99e088b.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/14b8b8db-c3b3-4c75-be5d-48a2f6a51446.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/af4a7d09-e957-4b82-a425-d7037427949b.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/26fd40ca-f11c-4711-a0dc-1adf2921f674.jpg\", \"type\": \"image\"}, {\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/eb610701-78ae-4b1c-981e-30cf55826e6b.jpg\", \"type\": \"image\"}]",
"projectName": "工地名称",
"companyId": "1638055605686038530",
"companyName": "公司名称",
"orgId": "1803264894489903106",
"deptName": "工程部",
"projectStatus": "IN_BUILDING",
"projectStatusDesc": "在建",
"createdTime": "2026-01-15 17:09:06",
"planStartDate": "2025-07-22",
"planEndDate": "2025-11-10",
"realStartDate": "2025-07-15",
"realEndDate": null,
"nodeId": "1932032040187572238",
"nodeName": "砌墙阶段"
},
{
"id": "2011727236835311617",
"projectId": "2000141298724368386",
"userName": "用户名称",
"userId": "1865660062253494274",
"positionId": "1638055156098596865",
"positionName": "岗位名称",
"stageName": "水电工程",
"content": "今日已提醒师傅下班后关闭水电,请您放心,谢谢。放水就必须需要。",
"imgAndVideoUrl": "[{\"url\": \"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202601/954ce619-0cb6-45a5-9b99-92bfd51c0805.mp4\", \"type\": \"video\"}]",
"projectName": "联丰大厦906",
"companyId": "1822187897504215042",
"companyName": "工地名称",
"orgId": "1822187941628289025",
"deptName": "工程部",
"projectStatus": "IN_BUILDING",
"projectStatusDesc": "在建",
"createdTime": "2026-01-15 10:20:25",
"planStartDate": "2025-08-15",
"planEndDate": "2025-12-10",
"realStartDate": "2025-09-15",
"realEndDate": null,
"nodeId": "1932032040120463378",
"nodeName": "水电阶段"
}
],
"total": "100",
"size": "10",
"current": "1",
"orders": [],
"optimizeCountSql": true,
"hitCount": false,
"countId": null,
"maxLimit": null,
"searchCount": true,
"pages": "3513"
},
"successful": true
}响应参数说明
| 参数名称 | 参数说明 | 类型 | 备注 |
|---|---|---|---|
| id | 动态记录ID | long | |
| projectId | 工地ID | long | |
| projectName | 工地名称 | string | |
| companyName | 工地所属公司名称 | string | |
| deptName | 工地所属部门名称, 可能为空 | string | |
| supervisorName | 主要负责人姓名 | string | |
| managerName | 次要负责人姓名 | string | |
| projectStatusDesc | 工地状态 | string | |
| content | 动态内容 | string | |
| stageName | 施工阶段 | string | |
| nodeName | 施工节点 | string | |
| userName | 动态发布人姓名 | string | |
| createdTime | 动态发布时间 | string | 格式: yyyy-MM-dd HH:mm:ss |
| imgAndVideoUrl | 图片或视频地址, JSON数组字符串表示 | string | |
| planStartDate | 计划开工时间 | string | 格式: yyyy-MM-dd |
| planEndDate | 计划完工时间 | string | 格式: yyyy-MM-dd |
| realStartDate | 实际开工时间 | string | 格式: yyyy-MM-dd |
| realEndDate | 实际完工时间 | string | 格式: yyyy-MM-dd |
作者:admin 创建时间:2023-07-18 16:24
最后编辑:liangxiong 更新时间:2026-01-29 21:49
最后编辑:liangxiong 更新时间:2026-01-29 21:49