创建部门接口

创建一个新部门。仅支持公共模式。

接口版本：

接口版本	更新时间	版本说明
v1	2018.12.4	使用 _id 作为 id
v2	2019.6.21	使用 dept_no 作为 id
v4	2022.6.30	返回值新增字段 type、status、integrate_id
v5	2022.10.28	在 v4 的基础上，接口请求频率由 5 次每秒提升至 20 次每秒；接口路由修改为 POST corp/department/create

**请求地址：**https://api.jiandaoyun.com/api/v5/corp/department/create

**请求频率：**20 次/秒

请求方式：POST

请求参数：

参数	是否必需	类型	说明
name	是	String	部门名称（最多不超过 32 个字符）
parent_no	否	Number	父部门编号，不传默认为根部门
dept_no	否	Number	部门编号，不传自动生成（上限 9007199254740991）

请求示例：

{
    "name": "研发部门",
    "parent_no": 1,
    "dept_no": 2
}

响应内容：

参数	类型	说明
department	Json	创建的部门信息。
dept_no	Number	部门编号
name	String	部门名称
parent_no	Number	父部门编号
type	Number	部门类型
status	Number	部门状态
integrate_id	String	集成模式同步部门关联 ID，仅在集成模式下返回，且在企业互联接口(外部对接人)不返回

响应示例：

{
  "department": {
    "dept_no": 2,
    "name": "研发部门",
    "parent_no": 1,
    "type": 0,
    "status": 1
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

name

string

必需

部门名称（最多不超过 32 个字符）

parent_no

number

可选

父部门编号，不传默认为根部门

dept_no

number

可选

部门编号，不传自动生成（上限 9007199254740991）

示例

{
    "name": "研发部门",
    "parent_no": 1,
    "dept_no": 2
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

department

object

创建的部门信息。

必需

dept_no

number

部门编号

必需

name

string

部门名称

必需

parent_no

number

父部门编号

必需

type

number

部门类型

必需

status

number

部门状态

必需

integrate_id

string

必需

集成模式同步部门关联 ID，仅在集成模式下返回，且在企业互联接口(外部对接人)不返回

示例

{
    "department": {
        "dept_no": 2,
        "name": "研发部门",
        "parent_no": 1,
        "type": 0,
        "status": 1
    }
}

创建部门接口