Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档（不推荐）
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API（DingTalk OpenAPI）
  • 生态伙伴API
获取凭证（access_token）身份验证（免登）应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理（官方CRM）培训智能硬件
获取凭证（access_token）身份验证（免登）应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理（官方CRM）培训智能硬件
  1. 智能人事
  • 花名册
    • 获取花名册字段组详情
      POST
    • 获取员工花名册字段信息
      POST
    • 更新员工花名册信息
      POST
    • 获取花名册元数据
      POST
  • 组织
    • 获取部门的扩展字段定义
      POST
    • 获取部门扩展信息
      POST
    • 更新部门扩展信息
      POST
  • 获取在职员工列表
    POST
  • 获取待入职员工列表
    POST
  • 获取员工离职信息
    POST
  • 获取离职员工列表
    POST
  • 添加企业待入职员工
    POST
  1. 智能人事

获取待入职员工列表

POST
http://127.0.0.1/topapi/smartwork/hrm/employee/querypreentry
服务端API/智能人事
最后修改时间：2022-08-30 09:19:21
责任人：未设置

说明#

调用本接口查询企业待入职员工userid列表。
服务地址：https://oapi.dingtalk.com

权限#

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考接口权限。
应用类型是否支持调用权限申请方式API Explorer调试
企业内部应用是开发者后台申请调试
第三方企业应用是开发者后台申请调试
第三方个人应用否——

请求参数

Query 参数
access_token
string 
必需
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
offset
number 
必需
分页游标，从0开始。根据返回结果里的next_cursor是否为空来判断是否还有下一页，且再次调用时offset设置成next_cursor的值。
size
number 
必需
分页大小，最大50。
示例
{
  "offset": 0,
  "size": 50
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/topapi/smartwork/hrm/employee/querypreentry?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "offset": 0,
    "size": 50
}'

返回响应

🟢200成功
application/json
Body
result
object 
返回结果。
可选
next_cursor
number 
可选
下一次分页调用的offset值，当返回结果里没有nextCursor时，表示分页结束。
data_list
array[string]
可选
查询到的待入职员工userid。
errcode
number 
返回码。
可选
errmsg
string 
返回码描述。
可选
success
boolean 
调用结果。
可选
request_id
string 
请求ID。
可选
示例
{
  "result": {
    "next_cursor": 0,
    "data_list": [
      "string"
    ]
  },
  "errcode": 0,
  "errmsg": "string",
  "success": true,
  "request_id": "string"
}
上一页
获取在职员工列表
下一页
获取员工离职信息
Built with