工地动态保存或新增

接口地址:/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

参数说明

startDateendDate格式都是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