获取打卡人员排班信息

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

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

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

错误码	说明
301021	userid错误
301070	系统错误，请稍后再试
301075	输入参数错误

文档ID: 25721
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93380
https://open.work.weixin.qq.com/api/doc/90001/90143/94208

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckinschedulist?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{ "starttime": 1492617600, "endtime": 1492790400, "useridlist": [ "james", "paul" ] }'

{ "errcode": 0, "errmsg": "string", "schedule_list": [ { "schedule": { "scheduleList": [ { "schedule_info": { "time_section": [ { "id": "string", "work_sec": "string", "off_work_sec": "string", "remind_work_sec": "string", "remind_off_work_sec": "string" } ], "schedule_id": 0, "schedule_name": "string" }, "day": 0 } ] }, "groupid": 0, "yearmonth": 0, "userid": "string", "groupname": "string" } ] }

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

useridlist

array[string]

可选

string[] 获取排班信息的userid列表。单个userid不少于1字节，不多于64字节可填充个数：1 ~ 100

endtime

integer <int32>

可选

获取排班信息的结束时间。0点Unix时间戳

starttime

integer <int32>

可选

获取排班信息的开始时间。0点Unix时间戳

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

schedule_list

array [object {5}]

排班表信息

可选

schedule

object

个人排班信息

可选

groupid

integer <int32>

打卡规则id

可选

yearmonth

integer <int32>

可选

排班表月份，格式为年月，如202011

userid

string

可选

打卡人员userid

groupname

string

打卡规则名

可选