跳至主要內容
全部系列開放平台API通訊錄 API
(遞歸)取得部門成員 API
(遞歸)取得部門成員 API
4 個月前已更新

簡介

API 簡介

能夠(遞歸)取得指定部門 ID 下的所有成員。

API 調用

能夠(遞歸)取得指定部門 ID 下的所有成員。

請求頻率:10 次/秒

請求方式:POST

請求參數

參數

類型

是否必需

說明

dept_no

Number

部門編號

has_child

Boolean

是否遞歸取得所有成員。預設為 false,即只取得當前部門下的成員,而不取得其子部門的成員。

請求範例

{    "dept_no":1,   "has_child": true }

回應內容

參數

含義

users

當前指定部門下的成員列表

單個成員的返回資料結構:

參數

含義

備註

name

暱稱

name 可以重複,重名成員的 name 相同

username

使用者名

username 在企業內是唯一的,不同企業之間可能存在重複

departments

使用者所屬的部門編號列表

/

type

部門類型

  • 0: 常規部門

status

部門狀態

  • 1: 使用中的部門

回應範例

{   "users": [     {       "username": "aubrey",       "name": "aubrey",       "departments": [1],       "type": 0,       "status": 1     }   ] }

是否回答了您的問題?