(遞歸)取得部門成員 API調試
簡介
API 簡介
能夠(遞歸)取得指定部門 ID 下的所有成員。
API 調用
能夠(遞歸)取得指定部門 ID 下的所有成員。
請求地址:https://api.jodoo.com/api/v5/corp/department/user/list
請求頻率:10 次/秒
請求方式:POST
請求參數:
參數 | 類型 | 是否必需 | 說明 |
dept_no | Number | 是 | 部門編號 |
has_child | Boolean | 否 | 是否遞歸取得所有成員。預設為 false,即只取得當前部門下的成員,而不取得其子部門的成員。 |
請求範例:
{
"dept_no":1,
"has_child": true
}
回應內容:
參數 | 含義 |
users | 當前指定部門下的成員列表 |
單個成員的返回資料結構:
參數 | 含義 | 備註 |
name | 暱稱 | name 可以重複,重名成員的 name 相同 |
username | 使用者名 | username 在企業內是唯一的,不同企業之間可能存在重複 |
departments | 使用者所屬的部門編號列表 | / |
type | 部門類型 |
|
status | 部門狀態 |
|
回應範例:
{
"users": [
{
"username": "aubrey",
"name": "aubrey",
"departments": [1],
"type": 0,
"status": 1
}
]
}