获取打卡人员排班信息

企业可通过打卡应用Secret调用本接口,获取打卡规则为“按班次上下班”规则的指定员工指定时间段内的排班信息。
第三方应用获取应用可见范围内、打卡规则为“按班次上下班”规则的指定员工指定时间段内的排班信息。

请求方式:POST(HTTPS)

请求地址:https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckinschedulist?access_token=ACCESS_TOKEN

请求示例

{
    "starttime": 1492617600,
    "endtime": 1492790400,
    "useridlist": [
        "james",
        "paul"
    ]
}

参数说明:

参数 必须 类型 说明
access_token string 调用接口凭证,必须使用打卡应用的Secret获取access_token,获取方式参考:文档-获取access_token
useridlist string[] 需要获取排班信息的用户列表(不超过100个)
starttime uint32 获取排班信息的开始时间。Unix时间戳
endtime uint32 获取排班信息的结束时间。Unix时间戳(与starttime跨度不超过一个月)

权限说明: (无特殊权限)

调用频率:
接口调用频率限制为60次/分钟。

返回结果:

{
    "schedule_list":[
        {
            "userid":"james",
            "yearmonth":202011,
            "groupid":11,
            "groupname":"排班",
            "schedule":{
                "scheduleList":[
                    {
                        "day":25,
                        "schedule_info":{
                            "schedule_id":229,
                            "schedule_name":"早班",
                            "time_section":[
                                {
                                    "id":1,
                                    "work_sec":32400,
                                    "off_work_sec":43200,
                                    "remind_work_sec":32400,                                         "remind_off_work_sec":43200
                                }
                            ]
                        }
                    },
                    {
                        "day":26,
                        "schedule_info":{
                            "schedule_id":171,
                            "schedule_name":"晚班",
                            "time_section":[
                                {
                                    "id":2,
                                    "work_sec":64800,
                                    "off_work_sec":79200,
                                    "remind_work_sec":64800,
                                    "remind_off_work_sec":79200
                                }
                            ]
                        }
                    },
                    {
                        "day":30,
                        "schedule_info":{
                            "schedule_id":0,
                            "schedule_name":"休息",
                            "time_section":[

                            ]
                        }
                    }
                ]
            }
        }
    ],
    "errcode":0,
    "errmsg":"ok"
}

参数说明:

参数 类型 说明
errcode int32 返回码
errmsg string 错误码描述
schedule_list obj[] 排班表信息
schedule_list.userid string 打卡人员userid
schedule_list.yearmonth uint32 排班表月份,格式为年月,如202011
schedule_list.groupid uint32 打卡规则id
schedule_list.groupname string 打卡规则名
schedule_list.schedule obj 个人排班信息
schedule_list.schedule.scheduleList obj[] 个人排班表信息
schedule_list.schedule.scheduleList.day uint32 排班日期,为表示当月第几天的数字
schedule_list.schedule.scheduleList.schedule_info obj 个人当日排班信息
schedule_list.schedule.scheduleList.schedule_info.schedule_id uint32 当日安排班次id,班次id也可在打卡规则中查询获得
schedule_list.schedule.scheduleList.schedule_info.schedule_name string 班次名称
schedule_list.schedule.scheduleList.schedule_info.time_section obj[] 班次上下班时段信息
schedule_list.schedule.scheduleList.schedule_info.time_section.id uint32 时段id,为班次中某一堆上下班时间组合的id
schedule_list.schedule.scheduleList.schedule_info.time_section.work_sec uint32 上班时间。距当天00:00的秒数
schedule_list.schedule.scheduleList.schedule_info.time_section.off_work_sec uint32 下班时间。距当天00:00的秒数
schedule_list.schedule.scheduleList.schedule_info.time_section.remind_work_sec uint32 上班提醒时间。距当天00:00的秒数
schedule_list.schedule.scheduleList.schedule_info.time_section.remind_off_work_sec uint32 下班提醒时间。距当天00:00的秒数

错误说明:

错误码 说明
301021 userid错误
301070 系统错误,请稍后再试
301075 输入参数错误
© 1998 - 2021 Tencent Inc. All Rights Reserved