查询虚拟部门列表
接口说明: 查询公司所有虚拟部门信息
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/department/virtual/list
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
data | List<VirtualDepartmentModel> | Y | 部门列表 |
DepartmentModel
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
adminId | String | Y | 部门负责人员工id |
city | String | Y | 所属城市 |
code | String | Y | 部门编码 |
departmentId | String | Y | 部门ID |
name | String | Y | 部门名称 |
parentId | String | N | 上级部门ID,上级部门为根部门时为空,虚拟部门的上级部门一定是非虚拟部门 |
hrbpId | String | Y | hrbp的员工id |
type | Integer | Y | 部门类型,默认0,固定部门类型有 0-部门,2-事业群,3-组,4-中心,5-子公司 其他部门自定义类型 详见部门类型列表接口中的departType字段 |
remark | String | N | 备注 |
fields | Map<String,String> | N | 部门的自定义字段,key为字段的名称,value为字段的值 |
addtime | Integer | Y | 添加时间 |
modtime | Integer | Y | 更新时间 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/department/virtual/list?sign=o0BvsXtuFqrXtt%2FzVvAYHIB9u6o%3D
请求Body示例:
{
"timestamp": 1606208919623
}
SDK请求示例(java):
DepartmentVirtualListRequest request = new DepartmentVirtualListRequest(access_token());
OpenapiResponse<List<DepartmentModel>> response = XrxsDepartmentService.getAllVirtualDeptList(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":[
{
"departmentId":"0207973e29c34a01a188bc39390296cb",
"name":"虚拟部门08",
"parentId":"",
"code":"virtual008",
"type":0,
"adminId":"",
"hrbpId":"",
"city":"石家庄市",
"remark":"备注:这是一个openapi测试部门",
"addtime":1686572121,
"modtime":1686572121,
"fields":{
"文本1":"我是单行文本11"
}
}
]
}