1. 批量查询项目信息

根据项目id组 批量查询项目信息

注意

  • 如果接口需要提供auth-token,你需要通过轻筑开放平台创建应用来获取appid和secret,然后通过appid和secret来获取接口访问凭证auth-token。
  • 如果需要获取当前用户的使用信息,授权确保你能获取到qzcode,然后通过网页授权接口获取相关信息。

1.1. 基本信息

概况 内容
接口地址 /project/batchGetByProjectIds
请求方法 POST
请求数据类型 JSON
响应数据类型 JSON

1.2. 请求数据

1.2.1. 请求头(request-header)

请求头除了默认的参数还需要添加如下请求头参数:

字段 描述
auth-token 接口访问凭据,你可以通过平台下发的appid和secret获取凭据
Content-Type application/json;charset=UTF-8

1.2.2. 请求体(request-body)

字段 类型 是否必填 描述
projectIds string 项目ids

1.3. 响应数据

响应数据中 code, message, data 为默认字段,所有字段如下表所示:

字段 类型 是否必填 描述
code string 响应码
msg string 响应信息
data array 响应数据
address string 详细地址
aliasName string 项目别名
buildCompany string 施工单位
buildCompanyId string 施工单位ID(从企业库中获取)
city string 市编码
code string 项目编码
constructCompany string 建设单位
constructCompanyId string 建设单位ID(从企业库中获取)
contractAmount number 合同金额
createTime number 数据创建时间
designCompany string 设计单位
designCompanyId string 设计单位ID(从企业库中获取)
endTime number 预计结束时间
enterpriseId string 所属企业ID
enterpriseOrgId string 企业组织机构ID
enterpriseOrgPath string 所属企业组织机构路径(组织机构序列 + 层级连接符 + 十六进制组织机构ID)
hasSection number 是否有标段项目(0=否 1=是)
isDelete number 是否删除(0=否 1=是)
latitude number 维度
longitude number 经度
name string 项目名称
operationNature string 经营性质
projectCompletionPercent number 完工百分比
projectId string 项目id
projectInitiationTime number 立项时间
projectLeaderName string 项目领导姓名
projectType number 项目类型(1 = 普通项目 2 = 父项目 3= 子项目 4=标段项目)
province string 省编码
realEndTime number 实际完工时间
realStartTime number 实际开工时间
region string 所在地区
remarks string 备注信息
responsibleUserId string 项目负责人id
shortName string 项目简称
startTime number 预计开始时间
state string 工程状态(1 = 筹备、2= 在建、3 = 停工、4 = 完工)
supervisionCompany string 监理单位
supervisionCompanyId string 监理单位ID
surveyCompany string 勘察单位
surveyCompanyId string 勘察单位ID
teamId string 团队ID
town string 区编码
type string 项目团队子类型id

响应数据结构如下所示:

{
    "code": "",
    "msg": "",
    "data": [
        {
            "address": "重庆市九龙坡区金凤镇高新大道",
            "aliasName": "",
            "buildCompany": "FF GLOBAL LIMITED",
            "buildCompanyId": "3e10dc1e-6c79-11e8-8fdd-00163e014a2c",
            "city": "620200",
            "code": "abn63R2i7S5xOYIq",
            "constructCompany": "AA管理有限公司",
            "constructCompanyId": "add6aeca-be2e-11e6-b646-00163f00240b",
            "contractAmount": 2345,
            "createTime": 1625794688000,
            "designCompany": "无敌II有限公司",
            "designCompanyId": "df1e15ba-be36-11e6-8ca8-00163e014a2c",
            "endTime": 1658281382000,
            "enterpriseId": "34b5e5d3f7ae4ee39b2d288b71d4230b",
            "enterpriseOrgId": "c70e4137ed724a30bdc57e9ac43c4ffe",
            "enterpriseOrgPath": "1F6C-1FA5-",
            "hasSection": 1,
            "isDelete": 0,
            "latitude": 29.511757,
            "longitude": 106.310641,
            "name": "测试项目_1",
            "operationNature": "2",
            "projectCompletionPercent": 32.2,
            "projectId": "50616f42e05611eb88ecfa163e8f29b8",
            "projectInitiationTime": 1670774400000,
            "projectLeaderName": "测试",
            "projectType": 3,
            "province": "620000",
            "realEndTime": 1718899200000,
            "realStartTime": 1685116800000,
            "region": "甘肃省 / 嘉峪关市",
            "remarks": "",
            "responsibleUserId": "c378463b7be2429b9817ee735edbc5ae",
            "shortName": "测试项目001",
            "startTime": 1625794980000,
            "state": "2",
            "supervisionCompany": "DD通讯有限公司",
            "supervisionCompanyId": "a41bfaa6-be02-11e6-bc44-00163e014a2c",
            "surveyCompany": "UUU-TRADING ASIA LIMITED",
            "surveyCompanyId": "c4348856-32b1-11e8-b21d-00163e014a2c",
            "teamId": "2cd4f0e0e8e949a1a7dbfbefcdd80a30",
            "town": "620200",
            "type": "43e1ed04ce4c11eb88ecfa163e8f29b8"
        }
    ]
}

1.4. 错误码

当返回数据中的 code 不为 0 时,为错误返回。其中errCode为详细的错误码。

© All Rights Reserved            updated 2024-08-23 10:14:55

results matching ""

    No results matching ""