文档中心 > 智能办公开发文档

dingtalk.smartwork.attends.listschedule (考勤排班信息按天全量查询接口)

按天查询企业考勤排班全量信息,使用分页功能

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
work_date Date 必须 2016-03-09 11:11:11 排班时间,只取年月日部分
offset Number 可选 0
  • 默认值:0
  • 偏移位置
    size Number 可选 200
  • 默认值:200
  • 分页大小,最大200

    响应参数

    名称 类型 示例值 描述
    result DingOpenResult {} result
    • └ ding_open_errcode
    • Number
    • 0
    • dingOpenErrcode
    • └ error_msg
    • String
    • ok
    • errorMsg
    • └ success
    • Boolean
    • true
    • success
    • result
    • AtScheduleListForTopVo
    • {}
    • result
    • └ has_more
    • Boolean
    • true
    • 分页用,表示是否还有下一页
    • schedules
    • AtScheduleForTopVo []
    • []
    • 排班列表
    • └ group_id
    • Number
    • 1
    • 考勤组id
    • └ plan_check_time
    • Date
    • 2017-04-11 11:11:11
    • 打卡时间
    • └ class_id
    • Number
    • 1
    • 考勤班次id
    • └ userid
    • String
    • 00001
    • userId
    • └ check_type
    • String
    • OnDuty
    • 打卡类型,Onduty表示上班打卡,OffDuty表示下班打卡
    • └ class_setting_id
    • Number
    • 1
    • 班次配置id,结果集中没有的话表示使用全局班次配置
    • └ approve_id
    • Number
    • 1
    • 审批id,结果集中没有的话表示没有审批单
    • └ plan_id
    • Number
    • 1
    • 排班id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://eco.taobao.com/router/rest");
    SmartworkAttendsListscheduleRequest req = new SmartworkAttendsListscheduleRequest();
    req.setWorkDate(StringUtils.parseDateTime("2016-03-09 11:11:11"));
    req.setOffset(0L);
    req.setSize(200L);
    SmartworkAttendsListscheduleResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <dingtalk_smartwork_attends_listschedule_response>
        <result>
            <ding_open_errcode>0</ding_open_errcode>
            <error_msg>ok</error_msg>
            <success>true</success>
            <result>
                <has_more>true</has_more>
                <schedules>
                    <at_schedule_for_top_vo>
                        <group_id>1</group_id>
                        <plan_check_time>2017-04-11 11:11:11</plan_check_time>
                        <class_id>1</class_id>
                        <userid>00001</userid>
                        <check_type>OnDuty</check_type>
                        <class_setting_id>1</class_setting_id>
                        <approve_id>1</approve_id>
                        <plan_id>1</plan_id>
                    </at_schedule_for_top_vo>
                </schedules>
            </result>
        </result>
    </dingtalk_smartwork_attends_listschedule_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部