项目信息数据
该接口用于获取项目信息数据，接口将返回大于指定version值的增量数据，返回结果将按数据的version字段进行升序排序，每次查询最多返回200条数据。
接口地址
GET /org-api/projects?start=12345&limit=200
请求参数
| 参数名称 |
说明 |
| start |
本次请求所要获取的增量数据的version起始值，客户端需要缓存接口返回的数据集合中最后一条数据的version值 |
| limit |
返回指定的数据条数 上限为200条 0 < limit <= 200 |
| custom |
定制标识 |
返回数据示例
[
{
"id": 21312,
"name": "xxx项目",
"shortName": "xxx项目简称",
"constructType": "xxx工程类别",
"province": "xxx省",
"address": "xxxxxxxxxx",
"zone": "东北片区",
"constructStatus": "none",
"overview": "xxxx",
"contractPrice": 123310000,
"planStart": "2018-08-06T16:00:00.000Z",
"planEnd": "2019-08-06T16:00:00.000Z",
"actualStart": "2018-08-06T16:00:00.000Z",
"planFinish": "2019-08-06T16:00:00.000Z",
"biddingUnit": "xxxxxx",
"designUnit": "xxxxxx",
"superviserUnit": "xxxxx",
"constructUnit": "xxxx",
"latitude": 39.976012,
"longitude": 116.319427,
"createTime": "2018-07-06T16:00:00.000Z",
"updateTime": "2018-09-06T16:00:00.000Z",
"version": 23232323,
"deleted": false
}
]
响应状态码
| 字段名称 |
数据类型 |
| 200 |
成功 |
| 400 |
用户请求头中Authorization值的格式不对，错误码：InvalidArgument。 |
| 403 |
AccessId不存在或被禁用 错误码：InvalidAccessId |
| 500 |
非法参数或接口执行异常 |
返回值
Object
| 字段名称 |
数据类型 |
是否可以为空 |
字段描述 |
| id |
string |
否 |
项目ID |
| integrationId |
string |
是 |
项目的集成ID |
| localId |
long |
否 |
项目在梦诚系统中的ID |
| name |
string |
否 |
项目名称 |
| shortName |
string |
否 |
项目简称 |
| constructType |
string |
是 |
工程类别 |
| province |
string |
是 |
所属省份 |
| address |
string |
是 |
工程地点 |
| zone |
string |
是 |
所属片区 |
| constructStatus |
string |
否 |
工程状态 见表1 |
| overview |
string |
是 |
工程概况 |
| contractPrice |
double |
是 |
合同金额, 单位: 元 |
| planStart |
date |
是 |
合同工期-开始，utc标准时间格式 |
| planEnd |
date |
是 |
合同工期-结束，utc标准时间格式 |
| actualStart |
date |
是 |
开工日期，utc标准时间格式 |
| planFinish |
date |
是 |
计划竣工，utc标准时间格式 |
| biddingUnit |
string |
是 |
建设单位 |
| designUnit |
string |
是 |
设计单位 |
| superviserUnit |
string |
是 |
监理单位 |
| constructUnit |
string |
是 |
施工单位 |
| longitude |
double |
是 |
经度 |
| latitude |
double |
是 |
纬度 |
| createTime |
date |
否 |
创建时间，utc标准时间格式 |
| updateTime |
date |
否 |
修改时间，utc标准时间格式 |
| version |
long |
否 |
数据版本 |
| deleted |
boolean |
否 |
逻辑删除标志位 见表2 |
表1 工程状态
| constructStatus |
|
| building |
在建 |
| stop |
停工 |
| finished |
完工 |
| none |
未指定 |
表2 逻辑删除标志位
| deleted |
|
| false |
未删除 |
| true |
已删除 |