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
    • 获取考勤组员工的userid
      POST
    • 批量获取考勤组摘要
      POST
    • 获取考勤组详情
      POST
    • 搜索考勤组摘要
      POST
    • 批量新增wifi信息
      POST
    • 批量移除wifi
      POST
    • 批量查询wifi
      POST
    • 批量新增position
      POST
    • 批量删除position
      POST
    • 批量查询position
      POST
    • 创建考勤组
      POST
    • 更新考勤组
      POST
    • 删除考勤组
      POST
    • 批量新增考勤组成员
      POST
    • 批量删除考勤组成员
      POST
    • 查询考勤组员工
      POST
    • 根据groupkey查询考勤组信息
      POST
    • groupKey转换为groupId
      POST
    • groupId转换为groupKey
      POST
  • 考勤打卡
    • 获取打卡结果
    • 获取打卡详情
    • 上传打卡记录
  • 考勤班次
    • 创建班次
    • 查询历史班次
    • 删除班次
    • 修改卡点设置
    • 按名称搜索班次
    • 获取班次详情
    • 获取班次摘要信息
  • 考勤排班
    • 查询成员排班信息
    • 批量查询人员排班信息
    • 排班制考勤组排班
    • 查询排班打卡结果
    • 查询企业考勤排班详情
    • 查询排班概要信息
  • 考勤统计
    • 获取考勤报表列定义
    • 获取考勤报表列值
    • 获取报表假期数据
    • 查询是否启用智能统计报表
    • 获取用户考勤数据
  • 考勤机管理
    • 查询员工智能考勤机列表
  • 假勤审批
    • 通知审批通过
      POST
    • 通知审批撤销
      POST
    • 通知补卡通过
      POST
    • 预计算时长
      POST
    • 通知换班通过
      POST
    • 计算请假时长
      POST
    • 查询请假状态
      POST
  • 假期管理
    • 添加假期类型
    • 删除假期类型
    • 更新假期类型
    • 查询假期类型
    • 初始化假期余额
    • 查询假期余额
    • 批量更新假期余额
    • 查询假期消费记录
  1. 假勤审批

查询请假状态

POST
http://127.0.0.1/topapi/attendance/getleavestatus
服务端API/考勤/假勤审批
最后修改时间：2022-08-30 09:19:22
责任人：未设置

说明#

调用本接口查询指定企业下指定用户在指定时间段内的请假状态。
服务地址：https://oapi.dingtalk.com

权限#

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

请求参数

Query 参数
access_token
string 
必需
调用服务端API的应用凭证，可通过获取企业内部应用的access_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
userid_list
string 
必需
待查询用户的ID列表，支持最多100个用户的批量查询。
start_time
number 
必需
开始时间 ，Unix时间戳，支持最多180天的查询。
end_time
number 
必需
结束时间，Unix时间戳，支持最多180天的查询。
offset
number 
必需
支持分页查询，与size参数同时设置时才生效，此参数代表偏移量，偏移量从0开始。
size
number 
必需
支持分页查询，与offset参数同时设置时才生效，此参数代表分页大小，最大20。
示例
{
  "start_time": 1538323200000,
  "offset": 0,
  "size": 10,
  "end_time": 1546358399000,
  "userid_list": "user123,user456"
}

示例代码

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/attendance/getleavestatus?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "start_time": 1538323200000,
    "offset": 0,
    "size": 10,
    "end_time": 1546358399000,
    "userid_list": "user123,user456"
}'

返回响应

🟢200成功
application/json
Body
errcode
number 
返回码。
可选
result
object 
查询结果。
可选
has_more
boolean 
是否有更多数据。
可选
leave_status
array [object {5}] 
请假状态列表。
可选
success
boolean 
请求是否成功。
可选
request_id
string 
请求ID。
可选
示例
{
  "errcode": 0,
  "result": {
    "has_more": true,
    "leave_status": [
      {
        "duration_unit": "string",
        "duration_percent": 0,
        "end_time": 0,
        "start_time": 0,
        "userid": "string"
      }
    ]
  },
  "success": true,
  "request_id": "string"
}
上一页
计算请假时长
下一页
添加假期类型
Built with