创建自定义校区或部门

POST

/v1.0/edu/customDepts

调用本接口，创建自定义校区或部门。

调用本接口，可创建自定义校区或部门。接口调用效果与下图操作实现效果一致。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	教育行业扩展通讯录写权限	API Explorer
第三方企业应用	支持	教育行业扩展通讯录写权限	API Explorer
第三方个人应用	暂不支持	教育行业扩展通讯录写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidParameter	PARAMETER INVALID	参数非法
400	illegalOrg	ILLEGAL ORG	未被组织授权
400	noRight	NO RIGHT	当前用户没有操作权限
400	invalidSubDeptType	INVALID SUB DEPT TYPE	部门下不能同时挂自定义部门和班级
500	systemBusy	SYSTEM BUSY	系统繁忙
500	createDeptFail	CREATE_DEPT_FAIL	创建部门失败

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dingtalk.com/v1.0/edu/customDepts' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

响应示例

{
  "success" : true,
  "result" : {
    "deptId" : 1234
  }
}

修改于 2024-01-23 03:44:56

初始化家校架构

创建学段

创建自定义校区或部门

权限#

错误码#

请求参数

返回响应

权限

错误码