创建园区项目新版SDK
更新于 2023-01-18
接口调用说明
每创建一个新项目,会创建对应的钉钉组织,钉钉组织名称与项目名称一致。项目创建成功后,对应的钉钉组织会自动关联为当前组织的上下游组织。
接口功能介绍
例如,开通地产行业的钉钉组织的企业管理后台内,项目通讯录内的信息如下图所示。


权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 行业化园区管理写权限 | API Explorer |
第三方企业应用 | 支持 | 行业化园区管理写权限 | API Explorer |
第三方个人应用 | 暂不支持 | 行业化园区管理写权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Body参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
campusName | String | 是 | 园区项目的名称。 |
belongProjectGroupId | Long | 否 | 归属的项目组ID。 |
telephone | String | 否 | 联系电话。 |
description | String | 否 | 园区项目的描述。 |
area | double | 否 | 园区项目面积。 说明
该参数指定的单位是平方千米。 |
country | String | 否 | 园区所在国家。 说明
国家名称,例如:中国。 |
provId | Integer | 否 | 园区所在省行政编码。 说明
例如山东省的行政编码为370000。 |
cityId | Integer | 否 | 园区所在市行政编码。 说明
例如山东省济南市的行政编码为370100。 |
countyId | Integer | 否 | 园区所在区/县行政编码。 说明
例如山东省济南市厉下区的行政编码为370102。 |
address | String | 否 | 园区所在详细地址信息。 |
capacity | Integer | 否 | 园区容量。 |
orderStartTime | Long | 否 | 项目订购开始时间戳,单位毫秒。 |
orderEndTime | Long | 否 | 项目订购结束时间戳,单位毫秒。 |
orderInfo | String | 否 | 订单信息。 说明
该参数值,开发者自定义。 |
extend | String | 否 | 扩展字段。 说明
该参数值,开发者自定义。例如: |
creatorUnionId | String | 是 | 创建人的unionId。 |
location | String | 否 | 经纬度,格式为:经度,维度。 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
campusCorpId | String | 园区组织CorpId。 |
campusDeptId | String | 园区组织在上下游组织内的部门ID。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
500 | system.error.contact | %s | 创建项目失败 |
500 | sytem.error | system error %s | 系统错误 |
500 | checkParam.invalid.notCampusTenantOrg | %s | 当前组织非园区租户组织 |
500 | system.error.campusProjectContactNotInit | %s | 项目通讯录未初始化 |