项目WBS数据
项目WBS数据(质量、安全问题数据的问题部位)
接口说明
该接口用于获取项目WBS数据,接口将返回大于指定version值的增量数据,返回结果将按数据的version字段进行升序排序,每次查询最多返回200条数据。
接口地址
/dw/wbs/project-wbs/v2?start=12345&limit=200&projectId=100001&types=01,02,03
接口类型
Http
请求方式
GET
内容类型
application/json
鉴权策略
参见《Open-API鉴权协议》
请求参数
| 参数名称 | 说明 |
|---|---|
| start | 本次请求所要获取的增量数据的version起始值,客户端需要缓存接口返回的数据集合中最后一条数据的version值 |
| limit | 返回指定的数据条数 上限为200条 0 < limit <= 200 |
| projectId | 项目ID 非必填 无该参数,则返回所有项目的WBS增量数据 |
| types | 该参数为空或不使用,则接口默认返回所有类型的WBS增量数据。如果指定该参数,则按参数类型值返回项目WBS增量数据,多个参数值,请使用半角逗号分割 如 types=01,02 |
响应报文
"data": [
{
"id": 400187391275008,
"parentId": 400187391094784,
"originalId": "143143099725184",
"originalParentId": "143143099606528",
"originalFullId": "143143099606528/143143099725184",
"name": "基坑围护及土方工程",
"typeKey": "02",
"level": 1,
"orderNo": 1,
"beginStake": null,
"endStake": null,
"designQuantity": null,
"unit": null,
"amount": null,
"longitude": null,
"latitude": null,
"isKeyUnitProject": null,
"orgId": 135302756025344,
"isRemoved": true,
"version": 400187396829184
}
]
响应状态码
| 字段名称 | 数据类型 |
|---|---|
| 200 | 成功 |
| 400 | 用户请求头中Authorization值的格式不对,错误码:InvalidArgument。 |
| 403 | AccessId不存在或被禁用 错误码:InvalidAccessId |
| 500 | 非法参数或接口执行异常 |
响应数据结构
| 字段名称 | 数据类型 | 是否可以为空 | 字段描述 |
|---|---|---|---|
| id | long | 否 | 平台侧WBS项数据ID |
| parentId | long | 是 | 平台侧父WBS项数据ID |
| originalId | string | 否 | 原始WBS项ID |
| originalParentId | string | 是 | 原始父WBS项ID |
| originalFullId | string | 是 | 原始WBS项全层级ID |
| name | string | 是 | wbs节点名称 |
| typeKey | string | 是 | 字典类型 见表1 |
| level | int | 是 | 级别 |
| orderNo | long | 是 | 顺序号,用于同一级别节点排序 |
| beginStake | string | 是 | 开始桩号 |
| endStake | string | 是 | 结束桩号 |
| designQuantity | double | 是 | 设计量 |
| unit | string | 是 | 单位 |
| amount | double | 是 | 金额 |
| longitude | double | 是 | 经度 |
| latitude | double | 是 | 纬度 |
| isKeyUnitProject | boolean | 是 | 是否为关键单位工程 |
| orgId | long | 否 | 组织ID |
| isRemoved | boolean | 否 | 是否删除 |
| version | long | 否 | 数据版本 |
表1 组织类型枚举值定义
| typeKey | |
|---|---|
| 01 | 单位工程 |
| 02 | 分部 |
| 03 | 分项 |
| 04 | 检验批 |