列出我连接的企业

能够获取所有外部部门的列表。支持公共模式和集成模式。

注：只返回已加入的, 不返回未加入和已解除的。

接口版本：

接口版本	更新时间	版本说明
v4	2022.4.21	初始版本：成员使用 username部门使用 dept_no包含 type 字段
V4	2022.6.30	返回值新增字段 status
v5	2022.10.28	在 v4 的基础上，接口请求频率由 5 次/秒提升至 30 次/秒；接口路由修改为 POST corp/guest/department/list

请求地址：https://api.jiandaoyun.com/api/v5/corp/guest/department/list

请求频率：30 次/秒

请求方式：POST

请求参数：

参数	类型	是否必须	说明
dept_no	integer	否	部门编号，不填则返回所有外部部门

请求示例：

{
    "dept_no": 1012
}

响应内容：

参数	类型	是否必需	说明
dept_list	Array	是	部门内容数组
name	String	是	部门名称
dept_no	Integer	是	部门编号
type	Number	是	部门类型0: 常规部2: 企业互联外部部门
status	Number	是	部门状态：1: 使用中的部门-1: 集成模式下同步后删除的部门
integrate_id	String	否	集成模式同步部门关联 ID

响应示例：

{
    "dept_list": [
        {
            "name": "帆软软件有限公司",
            "dept_no": 1012,
            "type": 2,
            "status": 1
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

dept_list

array [object {5}]

部门内容数组

必需

name

string

部门名称

必需

dept_no

number

部门编号

必需

type

number

必需

部门类型 0: 常规部 2: 企业互联外部部门

status

number

必需

部门状态： 1: 使用中的部门 -1: 集成模式下同步后删除的部门

integrate_id

string

可选

集成模式同步部门关联 ID

示例

{
    "dept_list": [
        {
            "name": "帆软软件有限公司",
            "dept_no": 1012,
            "type": 2,
            "status": 1
        }
    ]
}

列出我连接的企业

列出我连接的企业#

请求参数

示例代码

返回响应

列出我连接的企业