組織成員清單

模板

全域

單點登錄

用戶

組織

群組

组织成员列表

請求說明

GET http://[SERVER:9022]/v1/org/employees_by_dept?access_token={access_token}&org_id={org_id}&dept_id={dept_id}&include_sub_dept={include_sub_dept}

请求參數：

字段	類型	是否必填	說明
access_token	string	Y	認證的token
org_id	string	Y	組織id
dept_id	string	Y	部門id
include_sub_dept	boolean	N	是否包含下級部門成員 true：包含（默認） false：不包含

返回结果示例

{
  "code": 0, 
  "msg": "ok",
   "data":[
     {
      "org": "companyA",
      "org_id":"1000000",
      "account_id": "200200021", // 員工工號
      "account": "kiso1k1", //帳號
      "nick_name": "13610117012",
      "status": "1",
      "mobile_prefix":"86",
      "phone": "13610117012",
      "email": "13610117012@qq.com",
      "gender": 1,
      "avatar":"http://...",
      "reg_time":"2024-12-12 15:53:07",
      "position":"$position_1",
      "dept_detail": [
                {
                    "dept_id": "1",
                    "dept_name": "xxx",
                    "is_dept_head":true
                },
                {
                    "dept_id": "2",
                    "dept_name": "xxx",
                    "is_dept_head":false
                }
            ]
        },
       {
         ....
       }
     
    ]
}

结果字段說明：

參數	類型	說明
data		用戶列表
org	string	組織名稱
org_id	string	組織id
account_id	string	用戶id
account	string	用戶帳號
nick_name	string	昵稱
status	int	“1”：正常，“2”：禁用，“3”：離職
mobile_prefix	int	手機號碼首碼：86
phone	string	手機號碼
email	string	郵箱
gender	int	性別，“1”：男，“2”：女
avatar	string	用戶頭像地址
reg_time	date	註冊時間yyyy-MM-dd HH: mm:ss
position	string	職務id
dept_detail		所在部門內的詳細資訊

dept_detail說明：

參數	類型	說明
dept_id	string	部門id
dept_name	string	部門名稱
is_dept_head	boolean	是否為部門（組織）負責人 true：是 false：否

状态码說明

code	message	說明
100040	Invalid params	參數錯誤
其他通用错误码