查询部门角色

接口描述

此接口用于查询部门角色

接口权限

本接口需要集团权限

请求URI

/api/openapi/department/roles

请求方式

GET

请求参数示例

• /api/openapi/department/roles?departmentCode=DEP-1&baseDate=2021-03-03
• /api/openapi/department/roles?departmentOID=58516027-c0c9-420a-aedf-f9d74ca4b2ed&baseDate=2021-03-03

请求参数说明

departmentCode和departmentOID二选一

参数名	类型	是否必填	说明
departmentCode	String		部门编码
departmentOID	UUID		部门OID
baseDate	String	否	基准日

接口返回示例

[
    {
        "departmentRoleCode": "3001",
        "employeeId": "EMP-001",
        "fromDate":"2020-04-01",
        "toDate":"2020-04-01"
    },
    {
        "departmentRoleCode": "6101",
        "employeeId": "EMP-002",
        "fromDate":"2020-04-01",
        "toDate":"2020-04-01"
    }
]

接口返回字段

参数名	类型	规则	说明
departmentRoleUser	DepartmentRoleUser[]		部门角色列表

DepartmentRoleUser

参数名	类型	规则	说明
departmentRoleCode	String	最大长度20	部门角色编码。部门经理编码为6101
employeeId	String	最大长度32	员工工号
fromDate	String	日期格式 yyyy-MM-dd	开始日期
toDate	String	日期格式 yyyy-MM-dd	结束日期

失败示例

{
    "message": "部门不存在",
    "errorCode": "6061002"
}

字段说明

字段名称	类型	说明
message	String	返回信息说明
errorCode	String	返回错误码

错误代码说明

errorCode	message	说明
120001	当前操作需要租户权限
6061002	部门不存在	无
6013009	日期格式为:yyyy-MM-dd	无