钉钉开发文档

查询企业在职员工列表

更新时间: 2019-7-18

分页查询企业在职员工userid列表。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/queryonjob?access_token=ACCESS_TOKEN
参数说明:

名称 类型 必须 示例值 描述
status_list String 2,3,5,-1 在职员工子状态筛选,其他状态无效。2,试用期;3,正式;5,待离职;-1,无状态
offset Number 0 分页游标,从0开始
size Number 20 分页大小,最大20

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/queryonjob");
OapiSmartworkHrmEmployeeQueryonjobRequest req = new OapiSmartworkHrmEmployeeQueryonjobRequest(); 
req.setStatusList("2,3"); 
req.setOffset(15); 
req.setSize(5); 
OapiSmartworkHrmEmployeeQueryonjobResponse response = client.execute(req , accessToken);

返回结果示例

{
    "result":{
        "next_cursor":10,
        "data_list":[
          "123",
          "234"
        ]
    },
    "errcode":0,
    "errmsg":"成功",
    "success":true
}

返回结果:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
success 调用是否成功
result 分页结果
└ next_cursor 下一次分页调用的offset值,当返回结果里没有nextCursor时,表示分页结束
└ data_list 员工userid列表
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!