一步工地新增(带设备)
接口地址:/openapi/project/auto/oneStepAdd
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
提示:
为保证大屏正常显示,工地地址格式为:省市区街道小区名称如:四川省成都市成华区仙韵二路33号泰博理想城
请求示例:
{
"projectDevices": [{
"serialNum": "DV6xxxxxx",
"bindDate": "2022-06-29 18:00:54"
}],
"houseOwners":[{
"userName":"张三",
"phoneNumber":"1235545"
}],
"project": {
"address": "xxxxxx泰博理想城",
"supervisorName": "李主要(主要负责人)",
"supervisorPhone": "1811xxx382",
"managerName": "张次要(次要负责人)",
"managerPhone": "1308xxx568",
"stageId": 1802656139923218436,
"name": "xxx邦泰天著18-1-13-52",
"planDays": 75,
"weekendWork": "true",
"applyToSecondMaster":false,
"latitude":"28.119164",
"longitude":"112.963421",
"productName":"产品名称",
"companyId":"xxx"
}
}请求参数:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| oneStepProjectAddParam | OneStepProjectAddParam | body | true | OneStepProjectAddParam | OneStepProjectAddParam |
| project | 项目信息 | true | ProjectPfVo | ProjectPfVo | |
| address | 详细地址 | false | string | ||
| applyToSecondMaster | 设备自动领用到次要负责人 | false | boolean | ||
| bathRoom | 卫 | false | integer | ||
| bedRoom | 室 | false | integer | ||
| budgetAmount | 预算 | false | number | ||
| buildArea | 建筑面积 | false | number | ||
| contractNo | 合同号 | false | string | ||
| estateName | 楼盘名称 | false | string | ||
| houseNum | 栋 | false | string | ||
| houseRoom | 房间号 | false | string | ||
| houseUnit | 单元 | false | string | ||
| innerArea | 室内面积 | false | number | ||
| latitude | 纬度 | false | string | ||
| longitude | 经度 | false | string | ||
| livingRoom | 厅 | false | integer | ||
| name | 工地名称 | true | string | ||
| stageId | 当前施工阶段ID | false | long | ||
| planDays | 计划工期 | true | integer | ||
| planStartDate | 计划开始时间 | true | string | ||
| productName | 产品名称 | false | string | ||
| supervisorPhone | 第一负责人电话 | true | string | ||
| supervisorName | 第一负责人名称 | true | string | ||
| managerPhone | 第二负责人电话 | true | string | ||
| managerName | 第二负责人名称 | true | string | ||
| weekendWork | 周末施工 | true | boolean | ||
| companyId | 公司id | false | string | ||
| zxbCustomerId | 签约工地id(如果为签约工地转在建工地,必填该字段) | false | long | ||
| contractAmountYuan | 合同金额 | false | BigDecimal | ||
| earnestAmountYuan | 定金金额 | false | BigDecimal | ||
| contractUrl | 合同附件url | false | string | ||
| cooperationCompanyId | 签约公司id | false | long | ||
| projectDevices | 项目设备列表 | true | array | ProjectDeviceVO | |
| area | 区域 | true | string | ||
| bindDate | 绑定时间 yyyy-MM-dd HH:mm:ss | true | string | ||
| serialNum | 设备串号 | true | string | ||
| houseOwners | 业主列表 | false | array | ProjectMember | |
| userName | 名称 | true | string | ||
| phoneNumber | 电话号码 | true | string | ||
| userId | 业主userId | false | long | ||
| idCard | 业主身份证号 | false | string | ||
| positionMemberMap | 工地相关成员(设计师数据) | false | array | ProjectMemberRequest | |
| 1363006906646626305 | 岗位id | integer(int64) | |||
| userName | 用户名称 | string | |||
| userId | 用户id | integer(int64) | |||
| orgId | 组织id | integer(int64) | |||
| orgName | 组织名称 | string | |||
| positionId | 岗位id | integer(int64) | |||
| positionName | 岗位名称 | integer(int64) | |||
| phoneNumber | 用户手机号 | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | Long | ||
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 200,
"data": "123456789522562",
"message": "",
"successful": true
}普通新增工地(推荐使用一步新增)
接口地址:/openapi/project/add
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"address": "",
"bathRoom": 0,
"bedRoom": 0,
"budgetAmount": 0,
"buildArea": 0,
"contractNo": "",
"customerName": "",
"customerPhone": "",
"estateName": "",
"houseNum": "1",
"houseRoom": "1",
"houseUnit": "1",
"innerArea": 0,
"latitude": "",
"livingRoom": 0,
"longitude": "",
"managerEopId": 0,
"name": "",
"planDays": 0,
"planStartDate": "",
"supervisorEopId": 0,
"weekendWork": false,
"stageId":0,
"productName":"产品名称"
}请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectPfVo | ProjectPfVo | body | true | ProjectPfVo | ProjectPfVo |
| name | 工地名称 | true | string | ||
| address | 详细地址 | true | string | ||
| supervisorEopId | 项目监理岗位关系id | true | integer(int64) | ||
| managerEopId | 项目经理岗位关系id | true | integer(int64) | ||
| planDays | 计划工期 | true | integer(int32) | ||
| planStartDate | 开工时间 | true | string(date-time) | ||
| weekendWork | 周末施工 | true | boolean | ||
| bathRoom | 卫 | false | integer(int32) | ||
| bedRoom | 室 | false | integer(int32) | ||
| budgetAmount | 预算 | false | number(bigdecimal) | ||
| buildArea | 建筑面积 | false | number(bigdecimal) | ||
| contractNo | 合同号 | false | string | ||
| customerName | 顾客名称 | false | string | ||
| customerPhone | 电话 | false | string | ||
| estateName | 楼盘名称 | false | string | ||
| houseNum | 栋 | false | string | ||
| houseRoom | 房间号 | false | string | ||
| houseUnit | 单元 | false | string | ||
| innerArea | 室内面积 | false | number(bigdecimal) | ||
| latitude | 纬度 | false | string | ||
| livingRoom | 厅 | false | integer(int32) | ||
| longitude | 经度 | false | string | ||
| realEndDate | 实际结束时间 | false | string(date-time) | ||
| realStartDate | 实际开始时间 | false | string(date-time) | ||
| stageId | 施工阶段ID | false | long | ||
| productName | 产品名称 | false | string | ||
| zxbCustomerId | 签约工地id(如果为签约工地转在建工地,必填该字段) | false | long | ||
| contractAmountYuan | 合同金额 | false | BigDecimal | ||
| earnestAmountYuan | 定金金额 | false | BigDecimal | ||
| contractUrl | 合同附件url | false | string | ||
| cooperationCompanyId | 签约公司id | false | long | ||
| houseOwners | 业主列表 | false | array | ProjectMember | |
| userName | 名称 | true | string | ||
| phoneNumber | 电话号码 | true | string | ||
| userId | 业主userId | false | long | ||
| idCard | 业主身份证号 | false | string | ||
| positionMemberMap | 工地相关成员(设计师数据) | false | array | ProjectMemberRequest | |
| 1363006906646626305 | 岗位id | integer(int64) | |||
| userName | 用户名称 | string | |||
| userId | 用户id | integer(int64) | |||
| orgId | 组织id | integer(int64) | |||
| orgName | 组织名称 | string | |||
| positionId | 岗位id | integer(int64) | |||
| positionName | 岗位名称 | integer(int64) | |||
| phoneNumber | 用户手机号 | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | 工地id | Long | |
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": {},
"message": "",
"successful": true
}工地修改
接口地址:/openapi/project/update
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"address": "",
"bathRoom": 0,
"bedRoom": 0,
"budgetAmount": 0,
"buildArea": 0,
"contractNo": "",
"estateName": "",
"houseNum": "",
"houseRoom": "",
"houseUnit": "",
"innerArea": 0,
"latitude": "",
"livingRoom": 0,
"longitude": "",
"name": "",
"planDays": 0,
"planStartDate": "",
"productName": "",
"projectId": 0,
"contractAmountYuan": 1.12,
"earnestAmountYuan": 1.1,
"cooperationCompanyId": 123,
"houseOwners":[{
"userName":"张三",
"phoneNumber":"1235545",
"userId": "1981250826076684289",
"idCard": "123123123123123"
}]
}请求参数:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectUpdateRequest | ProjectUpdateRequest | body | true | ProjectUpdateRequest | ProjectUpdateRequest |
| address | 详细地址 | false | string | ||
| bathRoom | 卫 | false | integer(int32) | ||
| bedRoom | 室 | false | integer(int32) | ||
| budgetAmount | 预算 | false | number(bigdecimal) | ||
| buildArea | 建筑面积 | false | number(bigdecimal) | ||
| contractNo | 合同号 | false | string | ||
| estateName | 楼盘名称 | false | string | ||
| houseNum | 栋 | false | string | ||
| houseRoom | 房间号 | false | string | ||
| houseUnit | 单元 | false | string | ||
| innerArea | 室内面积 | false | number(bigdecimal) | ||
| latitude | 纬度 | false | string | ||
| livingRoom | 厅 | false | integer(int32) | ||
| longitude | 经度 | false | string | ||
| name | 工地名称 | false | string | ||
| planDays | 计划工期 | false | integer(int32) | ||
| planStartDate | 计划开始时间 | true | string(date-time) | ||
| productName | 产品名称 | false | string | ||
| projectId | 工地ID | false | integer(int64) | ||
| contractAmountYuan | 合同金额 | false | number(bigdecimal) | ||
| earnestAmountYuan | 定金金额 | false | number(bigdecimal) | ||
| cooperationCompanyId | 签约公司id | false | long | ||
| houseOwners | 业主列表 | false | array | ProjectMember | |
| userName | 名称 | true | string | ||
| phoneNumber | 电话号码 | true | string | ||
| userId | 业主userId | false | long | ||
| idCard | 业主身份证号 | false | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | object | ||
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 200,
"data": {},
"message": "",
"successful": true
}绑定设备
接口地址:/openapi/project/bindDevice
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
[
{
"area": "",
"bindDate": "",
"deviceId": 0,
"projectId": 0,
"serialNumber":"xx"
}
]请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectDeviceVOs | ProjectDeviceVO | body | true | array | ProjectDeviceVO |
| area | 区域 | true | string | ||
| bindDate | 绑定时间 yyyy-MM-dd HH:mm:ss | false | string(date-time) | ||
| deviceId | 设备ID | false | integer(int64) | ||
| serialNumber | 序列号 | false | string | ||
| projectId | 工地ID:新增不需要;绑定设备需要 | false | integer(int64) |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | object | ||
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": {},
"message": "",
"successful": true
}解绑设备
接口地址:/openapi/project/unbindDevice
请求方式:POST
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectId | projectId | query | true | integer(int64) | |
| deviceId | deviceId | query | false | integer(int64) | |
| serialNumber | serialNumber | query | false | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | object | ||
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": {},
"message": "",
"successful": true
}确认开工(yyyy-MM-dd)
接口地址:/openapi/project/confirmProjectStart
请求方式:POST
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectId | projectId | query | true | integer(int64) | |
| startTime | startTime | query | true | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | object | ||
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": {},
"message": "",
"successful": true
}工地完工(yyyy-MM-dd)
接口地址:/openapi/project/completeProject
请求方式:POST
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectId | projectId | query | true | integer(int64) | |
| endTime | endTime | query | true | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | object | ||
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": {},
"message": "",
"successful": true
}分页列表
接口地址:/openapi/project/pageList
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"companyId": 0,
"contractNo": "",
"customer": "",
"deviceStatus": "",
"estateName": "",
"installStatus": "",
"managerId": 0,
"progressStatus": "",
"projectName": "",
"statusList": [],
"supervisorId": 0,
"orgId":0,
"projectIds":[],
"productName": "",
"sampleProject":true,
"contractNoList":["xx","xxx"]
}请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectRequestPfParam | ProjectRequestPfParam | body | true | ProjectRequestPfParam | ProjectRequestPfParam |
| orgId | 组织id | false | integer(int64) | ||
| companyId | 组织-公司 | false | integer(int64) | ||
| contractNo | 合同号 | false | string | ||
| customer | 业主姓名或电话 | false | string | ||
| deviceStatus | 设备状态 ONLINE,OFF_LINE | false | string | ||
| estateName | 楼盘 | false | string | ||
| installStatus | 安装状态 | false | string | ||
| managerId | 经理 | false | integer(int64) | ||
| progressStatus | 逾期状态,NORMAL,DELAYING,IN_TIME_COMPLETED,ADVANCED_COMPLETED,DELAYED_COMPLETED | false | string | ||
| projectName | 工地名称 | false | string | ||
| statusList | 工地状态 多选,NOT_WORK,WAIT_WORK,IN_BUILDING,PAUSING,BEEN_COMPLETED | false | array | string | |
| supervisorId | 监理 | false | integer(int64) | ||
| projectIds | 工地ID列表 | false | integer(int64) | ||
| productName | 产品名称 | false | string | ||
| sampleProject | 样板工地 | false | string | ||
| contractNoList | 合同号列表 | false | string | ||
| pageNo | pageNo | query | false | integer(int32) | |
| pageSize | pageSize | query | false | integer(int32) |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«open-platform 分页简单对象«ProjectPfVo»» |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | open-platform 分页简单对象«ProjectPfVo» | open-platform 分页简单对象«ProjectPfVo» | |
| current | 当前页 | integer(int64) | |
| records | 查询数据列表 | array | ProjectPfVo |
| id | id | long | |
| address | 详细地址 | string | |
| bathRoom | 卫 | integer | |
| bedRoom | 室 | integer | |
| budgetAmount | 预算 | number | |
| buildArea | 建筑面积 | number | |
| contractNo | 合同号 | string | |
| customerName | 顾客名称 | string | |
| customerPhone | 电话 | string | |
| estateName | 楼盘名称 | string | |
| houseNum | 栋 | string | |
| houseRoom | 房间号 | string | |
| houseUnit | 单元 | string | |
| innerArea | 室内面积 | number | |
| latitude | 纬度 | string | |
| livingRoom | 厅 | integer | |
| longitude | 经度 | string | |
| stageId | 施工阶段ID | long | |
| managerEopId | 监理岗位关系id | integer | |
| name | 工地名称 | string | |
| planDays | 计划工期 | integer | |
| planStartDate | 计划开始时间 | string | |
| realEndDate | 实际结束时间 | string | |
| realStartDate | 实际开始时间 | string | |
| supervisorEopId | 监理岗位关系id | integer | |
| deviceStatus | 设备状态:ONLINE->在线,OFFLINE -> 离线 | integer | |
| installStatus | 设备绑定状态: INSTALL->绑定, UNINSTALL-> 未绑定 | string | |
| weekendWork | 周末施工 | boolean | |
| productName | 产品名称 | string | |
| size | 每页显示条数 | integer(int64) | |
| total | 总数 | integer(int64) | |
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": {
"current": 0,
"records": [
{
"id": "",
"address": "",
"bathRoom": 0,
"bedRoom": 0,
"budgetAmount": 0,
"buildArea": 0,
"contractNo": "",
"customerName": "",
"customerPhone": "",
"estateName": "",
"houseNum": "0",
"houseRoom": "0",
"houseUnit": "0",
"innerArea": 0,
"latitude": "",
"livingRoom": 0,
"longitude": "",
"managerEopId": 0,
"name": "",
"planDays": 0,
"planStartDate": "",
"realEndDate": "",
"realStartDate": "",
"supervisorEopId": 0,
"deviceStatus":",
"installStatus":"",
"weekendWork": false,
"stageId": 0,
"productName": ""
}
],
"size": 0,
"total": 0
},
"message": "",
"successful": true
}详情
接口地址:/openapi/project/detail/{id}
请求方式:GET
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| id | id | path | true | integer(int64) |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«ProjectVo» |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | ProjectVo | ProjectVo | |
| address | 地址 | string | |
| bathRoom | 卫 | integer(int32) | |
| bedRoom | 室 | integer(int32) | |
| budgetAmount | 预算 | number(bigdecimal) | |
| buildArea | 建筑面积 | number(bigdecimal) | |
| companyId | 公司ID | integer(int64) | |
| companyName | 公司 | string | |
| contractId | 合同ID | integer(int64) | |
| contractNo | 合同号 | string | |
| contractOrgId | 合同组织ID | integer(int64) | |
| contractOrgName | 合同组织 | string | |
| countNum | integer(int32) | ||
| createdTime | 创建时间 | string(date-time) | |
| customerName | 业主姓名 | string | |
| customerPhone | 业主电话 | string | |
| delayReason | 停工原因 状态为停工显示此值 | string | |
| delayReportNum | 报告数量 | integer(int32) | |
| delayStartDate | 停工日期 | string(date-time) | |
| designerCompanyId | integer(int64) | ||
| designerCompanyName | 设计师 公司D | string | |
| designerId | 设计师userId | integer(int64) | |
| designerName | string | ||
| designerOrgId | integer(int64) | ||
| designerOrgName | 设计师 组织 | string | |
| deviceNums | 设备数量 | integer(int32) | |
| deviceStatus | 设备状态 ONLINE,OFFLINE | string | |
| deviceStatusDesc | string | ||
| estateName | 楼盘 | string | |
| houseNum | 栋 | string | |
| houseRoom | 房间号 | string | |
| houseUnit | 单元 | string | |
| id | integer(int64) | ||
| innerArea | 室内面积 | number(bigdecimal) | |
| installStatus | 工地设备绑定状态 INSTALL,UNINSTALL | string | |
| installStatusDesc | string | ||
| lastSnapshot | 最新快照 | string | |
| latestDelayDate | string(date-time) | ||
| latestDelayReason | string | ||
| latestStopDate | string(date-time) | ||
| latestStopReason | string | ||
| latitude | 纬度 | string | |
| productName | 产品名称 | string | |
| leaveDays | 剩余工期 | integer(int64) | |
| livingRoom | 厅 | integer(int32) | |
| longitude | 经度 | string | |
| managerId | 项目经理 | integer(int64) | |
| managerName | string | ||
| memberNums | 项目成员人数 | integer(int32) | |
| name | 工地名称 | string | |
| offlineStartTime | string(date-time) | ||
| onlineCountNum | integer(int32) | ||
| orgId | integer(int64) | ||
| orgName | 施工组织 | string | |
| planDays | 计划工期 | integer(int32) | |
| planEndDate | 计划结束时间 | string(date-time) | |
| planStartDate | 计划开始时间 | string(date-time) | |
| progress | string | ||
| progressDesc | 进度 | string | |
| realEndDate | 实际结束时间 | string(date-time) | |
| realStartDate | 实际开始时间 | string(date-time) | |
| snapShotNums | 快照数量 | integer(int64) | |
| startCountDownDays | 开工倒计时 | integer(int64) | |
| status | string | ||
| statusDesc | 工地状态 NOT_WORK,WAIT_WORK,IN_BUILDING,PAUSING,BEEN_COMPLETED | string | |
| stopDays | 停工天数 | integer(int64) | |
| style | 风格 : RENOVATION_STYLE | string | |
| styleDesc | string | ||
| supervisorId | 项目监理 | integer(int64) | |
| supervisorName | string | ||
| supervisorPhone | string | ||
| weekendWork | 周末施工 | boolean | |
| workDays | 施工天数 | integer(int64) | |
| workerNums | 工人数量 | integer(int32) | |
| stageId | 施工阶段ID | long | |
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": {
"address": "",
"bathRoom": 0,
"bedRoom": 0,
"budgetAmount": 0,
"buildArea": 0,
"companyId": 0,
"companyName": "",
"contractId": 0,
"contractNo": "",
"contractOrgId": 0,
"contractOrgName": "",
"countNum": 0,
"createdTime": "",
"customerName": "",
"customerPhone": "",
"delayReason": "",
"delayReportNum": 0,
"delayStartDate": "",
"designerCompanyId": 0,
"designerCompanyName": "",
"designerId": 0,
"designerName": "",
"designerOrgId": 0,
"designerOrgName": "",
"deviceNums": 0,
"deviceStatus": "",
"deviceStatusDesc": "",
"estateName": "",
"houseNum": "0",
"houseRoom": "0",
"houseUnit": "0",
"id": 0,
"innerArea": 0,
"installStatus": "",
"installStatusDesc": "",
"lastSnapshot": "",
"latestDelayDate": "",
"latestDelayReason": "",
"latestStopDate": "",
"latestStopReason": "",
"latitude": "",
"leaveDays": 0,
"livingRoom": 0,
"longitude": "",
"managerId": 0,
"managerName": "",
"memberNums": 0,
"name": "",
"offlineStartTime": "",
"onlineCountNum": 0,
"orgId": 0,
"orgName": "",
"planDays": 0,
"planEndDate": "",
"planStartDate": "",
"progress": "",
"progressDesc": "",
"realEndDate": "",
"realStartDate": "",
"snapShotNums": 0,
"startCountDownDays": 0,
"status": "",
"statusDesc": "",
"stopDays": 0,
"style": "",
"styleDesc": "",
"supervisorId": 0,
"supervisorName": "",
"supervisorPhone": "",
"weekendWork": false,
"workDays": 0,
"workerNums": 0,
"productName": ""
},
"message": "",
"successful": true
}详情列表
接口地址:/openapi/project/detailList
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| param | param | body | true | ProjectOpParam | |
| contractNoList | 合同号列表 | List | true | String(int64) |
请求示例
{
"contractNoList":["00134","23203"]
}响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«ProjectOpVo» |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | ProjectOpVo | ProjectOpVo | |
| id | 工地ID | string | |
| name | 地工地名称 | string | |
| contractNo | 合同号 | string | |
| deviceList | 设备列表 | DeviceOpVo | |
| serialNum | 设备序列号 | String | |
| online | 是否在线 | Boolean |
响应示例:
[
{
"id": "1",
"name": "***",
"contractNo": "23203",
"deviceList": [
{
"deviceId": "11",
"serialNum": "aaa",
"online": false
}
]
},
{
"id": "2",
"name": "###",
"contractNo": "00134",
"deviceList": [
{
"deviceId": "33",
"serialNum": "ccc",
"online": false
}
]
}
]根据工地查询已绑定的设备
接口地址:/openapi/project/beenBindDeviceList
请求方式:GET
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectId | 项目id | query | false | integer(int64) | |
| contractNo | 合同号 | query | false | string |
- projectId和contractNo二选一
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«List«ProjectDeviceVO»» |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | array | ProjectDeviceVO | |
| area | 区域 | string | |
| bindDate | 绑定时间 yyyy-MM-dd HH:mm:ss | string(date-time) | |
| deviceId | 设备ID | integer(int64) | |
| projectId | 工地ID:新增不需要;绑定设备需要 | integer(int64) | |
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": [
{
"area": "",
"bindDate": "",
"deviceId": 0,
"projectId": 0
}
],
"message": "",
"successful": true
}查询当前工地可以绑定的设备
接口地址:/openapi/project/queryCanBindDeviceByProjectId/{projectId}
请求方式:GET
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectId | projectId | path | true | integer(int64) |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«List«ProjectDeviceVO»» |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | array | ProjectDeviceVO | |
| area | 区域 | string | |
| bindDate | 绑定时间 yyyy-MM-dd HH:mm:ss | string(date-time) | |
| deviceId | 设备ID | integer(int64) | |
| projectId | 工地ID:新增不需要;绑定设备需要 | integer(int64) | |
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": [
{
"area": "",
"bindDate": "",
"deviceId": 0,
"projectId": 0
}
],
"message": "",
"successful": true
}查询监理的设备
接口地址:/openapi/project/queryCanBindDeviceBySupervisorId
请求方式:GET
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| supervisorUserId | supervisorUserId | query | true | integer(int64) |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«List«ProjectDeviceVO»» |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | array | ProjectDeviceVO | |
| deviceId | 设备ID | integer(int64) | |
| serialNum | 设备序列号 | String | |
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": [
{
"deviceId": 0,
"serialNum":"xxxx"
}
],
"message": "",
"successful": true
}查询设计师并带出岗位公司部门
接口地址:/openapi/project/queryDesignerListWithCompany
请求方式:GET
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| keyword | keyword | query | true | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«List«EmployeeDeptPfVo»» |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | array | EmployeeDeptPfVo | |
| companyId | 公司id | integer(int64) | |
| companyName | 公司名称 | string | |
| deptId | 部门id | integer(int64) | |
| deptName | 部门名称 | string | |
| eid | integer(int64) | ||
| eopId | 职位员工关联id(添加工地时使用) | integer(int64) | |
| name | 名称 | string | |
| orgId | 部门id | integer(int64) | |
| orgName | 部门名称 | string | |
| phone | 电话 | string | |
| positionId | 职位id | integer(int64) | |
| positionName | 职位名称 | string | |
| positionType | 职位类型 | string | |
| userId | 用户id | integer(int64) | |
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": [
{
"companyId": 0,
"companyName": "",
"deptId": 0,
"deptName": "",
"eid": 0,
"eopId": 0,
"name": "",
"orgId": 0,
"orgName": "",
"phone": "",
"positionId": 0,
"positionName": "",
"positionType": "",
"userId": 0
}
],
"message": "",
"successful": true
}查询项目第二负责人并带出岗位公司部门
接口地址:/openapi/project/queryManagerListWithCompany
请求方式:GET
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| keyword | keyword | query | true | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«List«EmployeeDeptPfVo»» |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | array | EmployeeDeptPfVo | |
| companyId | 公司id | integer(int64) | |
| companyName | 公司名称 | string | |
| deptId | 部门id | integer(int64) | |
| deptName | 部门名称 | string | |
| eid | integer(int64) | ||
| eopId | 职位员工关联id(添加工地时使用) | integer(int64) | |
| name | 名称 | string | |
| orgId | 部门id | integer(int64) | |
| orgName | 部门名称 | string | |
| phone | 电话 | string | |
| positionId | 职位id | integer(int64) | |
| positionName | 职位名称 | string | |
| positionType | 职位类型 | string | |
| userId | 用户id | integer(int64) | |
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": [
{
"companyId": 0,
"companyName": "",
"deptId": 0,
"deptName": "",
"eid": 0,
"eopId": 0,
"name": "",
"orgId": 0,
"orgName": "",
"phone": "",
"positionId": 0,
"positionName": "",
"positionType": "",
"userId": 0
}
],
"message": "",
"successful": true
}查询项目第一负责人并带出岗位公司部门
接口地址:/openapi/project/querySupervisorListWithCompany
请求方式:GET
请求数据类型:application/x-www-form-urlencoded
响应数据类型:*/*
接口描述:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| keyword | keyword | query | true | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«List«EmployeeDeptPfVo»» |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | array | EmployeeDeptPfVo | |
| companyId | 公司id | integer(int64) | |
| companyName | 公司名称 | string | |
| deptId | 部门id | integer(int64) | |
| deptName | 部门名称 | string | |
| eid | integer(int64) | ||
| eopId | 职位员工关联id(添加工地时使用) | integer(int64) | |
| name | 名称 | string | |
| orgId | 部门id | integer(int64) | |
| orgName | 部门名称 | string | |
| phone | 电话 | string | |
| positionId | 职位id | integer(int64) | |
| positionName | 职位名称 | string | |
| positionType | 职位类型 | string | |
| userId | 用户id | integer(int64) | |
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": [
{
"companyId": 0,
"companyName": "",
"deptId": 0,
"deptName": "",
"eid": 0,
"eopId": 0,
"name": "",
"orgId": 0,
"orgName": "",
"phone": "",
"positionId": 0,
"positionName": "",
"positionType": "",
"userId": 0
}
],
"message": "",
"successful": true
}调整工期
接口地址:/openapi/project/delayByOpenApi
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
参数说明
1. contractNo或者projectId两个至少保证有一个字段有值;请求示例(正常延期):
{
"contractNo": "",
"projectId": 0,
"delayDays": 100
}请求示例(直接设置工期及计划开工完工日期):
{
"contractNo": "",
"projectId": 0,
"projectPlanDays": 10,
"projectPlanEndDate": "2024-08-08",
"projectPlanStartDate": "2024-08-01"
}请求参数:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectPauseDelayVo | ProjectPauseDelayVo | body | true | ProjectPauseDelayVo | ProjectPauseDelayVo |
| contractNo | 合同号 | false | string | ||
| projectId | 工地id | false | integer(int64) | ||
| delayDays | 延期天数 | false | integer(int32) | ||
| projectPlanDays | 工地计划工期 | false | integer(int32) | ||
| projectPlanEndDate | 工地计划完工时间 | false | string(date-time) | ||
| projectPlanStartDate | 工地计划开工时间 | false | string(date-time) |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«boolean» |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | boolean | ||
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": true,
"message": "",
"successful": true
}暂停施工
接口地址:/openapi/project/pauseByOpenApi
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
参数说明
1. contractNo或者projectId两个至少保证有一个字段有值;请求示例:
{
"contractNo": "",
"projectId": 0,
"pauseRecoverDate": "2024-08-09",
"pauseStartDate": "2024-08-01",
"delayDays":8
}请求参数:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| projectPauseDelayVo | ProjectPauseDelayVo | body | true | ProjectPauseDelayVo | ProjectPauseDelayVo |
| contractNo | 工地合同号 | false | string | ||
| projectId | 工地id | false | integer(int64) | ||
| pauseRecoverDate | 复工时间 | false | string(date-time) | ||
| pauseStartDate | 计划停工的时间 | false | string(date-time) | ||
| delayDays | 停工天数 | false | integer |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«boolean» |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int32) | integer(int32) | |
| data | boolean | ||
| message | string | ||
| successful | boolean |
响应示例:
{
"code": 0,
"data": true,
"message": "",
"successful": true
}最后编辑:admin 更新时间:2026-01-29 21:48