项目形象进度
接口说明
该接口用于获取项目形象进度
接口地址
/external/project-progress?startId=0&startVersion=0&limit=200&orgId=115448070424192
接口类型
Http
请求方式
GET
内容类型
application/json
鉴权策略
参见《Open-API鉴权协议》
请求参数
| 参数名称 | 说明 |
|---|---|
| startId | 本次请求所要获取的增量数据的id起始值,第一次调用初始值为0，客户端需要缓存接口返回的数据集合中最后一条数据的id值 |
| startVersion | 本次请求所要获取的增量数据的version起始值,第一次调用初始值为0，客户端需要缓存接口返回的数据集合中最后一条数据的version值 |
| limit | 返回指定的数据条数，上限为500条，0 <= limit <= 500。如果limit > 500, 则最多返回500条数据 |
| orgId | 组织机构Id |
请求头
响应报文
[
{
"id": 10254,
"orgId": 115448070424192,
"name": "人行横洞",
"categoryName": "隧道工程",
"firstUnitType": 1,
"firstUnit": "处",
"secondUnitType": 1,
"secondUnit": null,
"keyProgress": true,
"orderNo": 53,
"commandProgressId": null,
"progressTemplateId":115448070424192,
"createdAt": "2018-06-02T11:17:30.000Z",
"updatedAt": "2018-07-25T06:46:13.000Z",
"removed": false,
"version": 171356373659735
}
]
响应状态码
| 字段名称 | 数据类型 |
|---|---|
| 200 | 成功 |
| 400 | 用户请求头中Authorization值的格式不对，错误码：InvalidArgument。 |
| 403 | AccessId不存在或被禁用 错误码：InvalidAccessId |
| 500 | 非法参数或接口执行异常 |
响应数据结构
| 字段名称 | 数据类型 | 是否可以为空 | 字段描述 |
|---|---|---|---|
| id | long | 否 | 形象进度项ID |
| orgId | long | 否 | 项目ID |
| name | string | 否 | 名称 |
| categoryName | string | 否 | 分类名称 |
| firstUnitType | int | 是 | 形象单位类型，0：工程量；1：计数；2：里程m；3：里程km |
| firstUnit | string | 是 | 形象单位 |
| secondUnitType | int | 是 | 过程统计方式，0：按形象单位；1：按百分比；2：按金额；3：按统计单位 |
| secondUnit | string | 是 | 统计单位 |
| keyProgress | boolean | 否 | 是否关键项 |
| orderNo | int | 否 | 排序号 |
| sourceProgressId | long | 是 | 对应的指挥部的形象进度Id |
| progressTemplateId | long | 是 | 形象进度模板Id |
| createdAt | date | 否 | 创建时间，utc标准时间格式 |
| updatedAt | date | 否 | 更新时间，utc标准时间格式 |
| removed | boolean | 否 | 是否删除 |
| version | long | 否 | 版本号 |