获取打卡人员排班信息

POST

/cgi-bin/checkin/getcheckinschedulist

企业可通过打卡应用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

请求示例

Shell

JavaScript

Java

Swift

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

打卡规则名

可选

修改于 2022-01-14 04:25:48

获取打卡月报数据

为打卡人员排班