钉钉开发文档

查询企业待入职员工列表

更新时间: 2018-10-8

接口功能分页查询企业离职员工userid列表

接口权限如果你是企业内部开发者(将自己公司的HR、OA、客户管理、业务管理等系统接入钉钉),则有权限调用。如果你是ISV(应用服务商,将开发的应用上架到钉钉应用市场,提供给其他企业用户使用),则默认无调用权限。本接口属于高权限接口,ISV如想调用,需要上ISV沟通组提交权限申请"查询钉钉HRM个人信息的权限"权限包。

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

入参说明

名称 类型 必须 示例值 描述
offset Number 0 分页游标,从0开始
size Number 50 分页大小,最大50

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/querypreentry");
OapiSmartworkHrmEmployeeQuerypreentryRequest req = new OapiSmartworkHrmEmployeeQuerypreentryRequest(); 
req.setOffset(0); 
req.setSize(50); 
OapiSmartworkHrmEmployeeQuerypreentryResponse response = client.execute(req , sessionKey);
System.out.println(rsp.getBody());

返回结果示例

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

出参说明:

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