获取部门下员工¶

功能说明¶

获取部门所有员工

接口地址¶

测试环境: https://openapi.guanaitong.tech/employee/getByDepartmentCode
生产环境: https://openapi.guanaitong.com/employee/getByDepartmentCode

HTTP请求方式¶

Method: POST
Content-Type: application/x-www-form-urlencoded

参数说明¶

公有参数

发送请求是必须传入公共参数，详见公共参数

私有参数

参数名称	是否必须	参数类型	长度限制	描述
dept_code	是	string	[1,50]	部门编码
enterprise_code	否	string	[1,20]	企业编号(集团和运营商必填,企业不填)
page_no	否	int		默认第1页
page_size	否	int		默认5000条

请求示例（HTTP）¶

https://openapi.guanaitong.tech/employee/getByDepartmentCode?
access_token=a9574640d1030306d684706ecbf5d84f&
dept_code=SZ001&sign=b314c43d96345a364c65c982ef1c95ab55fa3482&
timestamp=1492671874

请求示例（JAVA SDK）¶

public class Main {
    public static OpenClient openClient = new OpenClient(Constants.BASE_URL_TEST, "xxx", "xxx");
    public static void main(String[] args) {
        EmployeeGetByDepartmentCodeRequest employeeGetByDepartmentCodeRequest = new EmployeeGetByDepartmentCodeRequest();
        employeeGetByDepartmentCodeRequest.setDeptCode("TomCompany_第二个部门");
        List<EmployeeGetResp> employeeGetRespList = openClient.employeeApi().getByDepartmentCode(employeeGetByDepartmentCodeRequest);
        System.out.println(JSON.toJSONString(employeeGetRespList));
    }
}

返回参数说明¶

参数名称	描述
code	返回码。详见错误返回码。
msg	如果错误，返回错误信息。
data	如果没有错误，返回员工数组
data.corp_code	员工工号
data.name	员工姓名
data.gender	员工性别
data.card_type	证件类型
data.card_no	证件号码
data.email	邮箱
data.mobile	手机号
data.remark	岗位名称
data.dept_name	部门名称
data.level	职级
data.birth_day	生日，格式为yyyy-MM-dd
data.entry_day	入职日期，格式为yyyy-MM-dd
data.time_created	注册日期
data.time_active	激活日期（首次登陆日期）

正确返回示例¶

{
  "code": 0,
  "data": [
    {
      "birth_day": null,
      "card_no": "",
      "card_type": 0,
      "level": "123",
      "dept_code": "A100",
      "corp_code": "CJJ006",
      "email": "jiajun.chu2@guanaitong.com",
      "entry_day": null,
      "gender": 2,
      "mobile": "15555555555",
      "name": "测试6",
      "remark": "",
      "time_active": 1411965741000,
      "time_created": 1406094253000
    }
  ],
  "msg": "OK"
}

错误返回示例¶

{
  "code": 1000220010,
  "data": null,
  "msg": "dept_code not exists !"
}

常见错误码¶

错误码	错误信息	排查方法
1000220002	参数验证不通过	检测参数是否按要求填写
1000240002	enterprise_code校验失败	检查enterprise_code是否是已绑定的编码
1000220010	dept_code not exists !	部门编号不存在，校验是否对应部门已添加
other	其他公共错误码	其他公共错误码