1 部门

1.1 查询下级部门信息

接口地址： POST /open-api/concat/dept-children

接口说明： 通过此接口根据部门编号查询下级部门信息。

header域

名称	类型	可空	默认	描述
AccessToken	String	N	-	基础接口获取

body域

名称	类型	可空	默认	描述
parentId	long	Y	公司	上级部门编号
pageNum	int	Y	1	页码
pageSize	int	Y	10	条数，最大50

返回数据

名称	类型	描述
code	int	0成功，1失败
msg	string	消息
data	object	返回数据
+list	list	数据记录
++deptId	long	部门编号
++parentId	long	上级部门编号
++deptName	string	部门名称
+pageNum	int	页码
+pageSize	int	条数
+total	int	记录总数

1.2 查询部门信息

接口地址： POST /open-api/concat/dept-info

接口说明： 通过此接口根据部门编号数组、部门名称查询公司下部门信息。

header域

名称	类型	可空	默认	描述
AccessToken	String	N	-	基础接口获取

body域

名称	类型	可空	默认	描述
deptIds	list[long]	Y	-	部门编号
deptName	string	Y	-	部门名称
pageNum	int	Y	1	页码
pageSize	int	Y	10	条数，最大50

返回数据

名称	类型	描述
code	int	0成功，1失败
msg	string	消息
data	object	返回数据
+list	list	数据记录
++deptId	long	部门编号
++parentId	long	上级部门编号
++deptName	string	部门名称
+pageNum	int	页码
+pageSize	int	条数
+total	int	记录总数

1.3 添加部门

接口地址： POST /open-api/concat/dept-save

接口说明： 通过此接口批量添加部门。

header域

名称	类型	可空	默认	描述
AccessToken	String	N	-	基础接口获取

body域

名称	类型	可空	默认	描述
depts	list	N	-	部门数据
+parentId	long	Y	公司	上级部门编号
+deptName	string	N	-	部门名称
operatorId	long	Y	-	操作人编号

返回数据

名称	类型	描述
code	int	0成功，1失败
msg	string	消息
data	list	返回数据
+tid	long	业务编号（部门编号）
+success	boolean	处理结果
+reason	string	失败原因

1.4 修改部门

接口地址： POST /open-api/concat/dept-edit

接口说明： 通过此接口批量修改部门。

header域

名称	类型	可空	默认	描述
AccessToken	String	N	-	基础接口获取

body域

名称	类型	可空	默认	描述
depts	list	N	-	部门数据
+deptId	long	N	-	部门编号
+parentId	long	N	-	上级部门编号
+deptName	string	N	-	部门名称
operatorId	long	Y	-	操作人编号

返回数据

名称	类型	描述
code	int	0成功，1失败
msg	string	消息
data	list	返回数据
+tid	long	业务编号（部门编号）
+success	boolean	处理结果
+reason	string	失败原因

1.5 删除部门

接口地址： POST /open-api/concat/dept-remove

接口说明： 通过此接口批量删除部门。

header域

名称	类型	可空	默认	描述
AccessToken	String	N	-	基础接口获取

body域

名称	类型	可空	默认	描述
deptIds	list[long]	N	-	部门编号数组
operatorId	long	Y	-	操作人编号

返回数据

名称	类型	描述
code	int	0成功，1失败
msg	string	消息
data	list	返回数据
+tid	long	业务编号（部门编号）
+success	boolean	处理结果
+reason	string	失败原因

2 人员

2.1 查询用户信息

接口地址： POST /open-api/concat/user-info

接口说明： 通过此接口根据部门编号、用户编号数组、用户名称查询用户信息。

header域

名称	类型	可空	默认	描述
AccessToken	String	N	-	基础接口获取

body域

名称	类型	可空	默认	描述
deptId	long	Y	-	部门编号
userIds	list[long]	Y	-	用户编号数组
userName	string	Y	-	用户名称
pageNum	int	Y	1	页码
pageSize	int	Y	10	条数，最大50

返回数据

名称	类型	描述
code	int	0成功，1失败
msg	string	消息
result	object	返回结果
+list	list	数据记录
++userId	long	用户编号
++deptIds	list[long]	部门编号数组
++userName	string	姓名
++sex	int	性别：0-男，1-女
++mobile	string	手机号
++roles	list[int]	角色数组标识符，详见附录3
++position	string	职务
++email	string	邮箱
++idCard	string	身份证号
++remark	string	备注
+pageNum	int	页码
+pageSize	int	条数
+total	int	记录总数

2.2 添加用户

接口地址： POST /open-api/concat/user-save

接口说明： 通过此接口批量添加用户。

header域

名称	类型	可空	默认	描述
AccessToken	String	N	-	基础接口获取

body域

名称	类型	可空	默认	描述
users	list	N	-	用户数据
+deptIds	list[long]	N	-	部门编号数组
+userName	string	N	-	姓名
+sex	int	N	-	性别：0-男，1-女
+mobile	string	N	-	手机号
+password	string	Y	-	密码
+roles	list[string]	N	-	角色数组标识符，详见附录3
+position	string	Y	-	职务
+email	string	Y	-	邮箱
+idCard	string	Y	-	身份证号
+remark	string	Y	-	备注
operatorId	long	N	-	操作人编号

返回数据

名称	类型	描述
code	int	0成功，1失败
msg	string	消息
data	list	返回数据
+tid	long	业务编号（用户编号）
+success	boolean	处理结果
+reason	string	失败原因

2.3 修改用户

接口地址： POST /open-api/concat/user-edit

接口说明： 通过此接口批量修改用户。

header域

名称	类型	可空	默认	描述
AccessToken	String	N	-	基础接口获取

body域

名称	类型	可空	默认	描述
users	list	N	-	用户数据
+userId	long	N	-	用户编号
+deptIds	list[long]	N	-	部门编号数组
+userName	string	N	-	姓名
+sex	int	N	-	性别：0-男，1-女
+mobile	string	N	-	手机号
+roles	list[string]	N	-	角色数组标识符，详见附录3
+position	string	Y	-	职务
+email	string	Y	-	邮箱
+idCard	string	Y	-	身份证号
+remark	string	Y	-	备注
operatorId	long	N	-	操作人编号

返回数据

名称	类型	描述
code	int	0成功，1失败
msg	string	消息
data	list	返回数据
+tid	long	业务编号（用户编号）
+success	boolean	处理结果
+reason	string	失败原因

2.4 删除用户

接口地址： POST /open-api/concat/user-remove

接口说明： 通过此接口批量删除用户。

header域

名称	类型	可空	默认	描述
AccessToken	String	N	-	基础接口获取

body域

名称	类型	可空	默认	描述
userIds	list[long]	N	-	用户编号数组
operatorId	long	N	-	操作人编号

返回数据

名称	类型	描述
code	int	0成功，1失败
msg	string	消息
data	list	返回数据
+tid	long	业务编号（用户编号）
+success	boolean	处理结果
+reason	string	失败原因

通讯录接口

1 部门#

1.1 查询下级部门信息#

1.2 查询部门信息#

1.3 添加部门#

1.4 修改部门#

1.5 删除部门#

2 人员#

2.1 查询用户信息#

2.2 添加用户#

2.3 修改用户#

2.4 删除用户#

1 部门

1.1 查询下级部门信息

1.2 查询部门信息

1.3 添加部门

1.4 修改部门

1.5 删除部门

2 人员

2.1 查询用户信息

2.2 添加用户

2.3 修改用户

2.4 删除用户