企业可通过具有调用权限的应用,为打卡规则为“按班次上下班”规则的指定员工排班。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/checkin/setcheckinschedulist?access_token=ACCESS_TOKEN
请求示例
{
"groupid": 226,
"items": [
{
"userid": "james",
"day": 5,
"schedule_id": 234
}
],
"yearmonth": 202012
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证。获取方式参考:文档-获取access_token |
items | 是 | 排班表信息 |
groupid | 是 | 打卡规则的规则id,可通过“获取打卡规则”、“获取打卡数据”、“获取打卡人员排班信息”等相关接口获取 |
userid | 是 | 打卡人员userid |
day | 是 | 要设置的天日期,取值在1-31之间。联合yearmonth组成唯一日期 比如20201205 |
schedule_id | 是 | 对应groupid规则下的班次id,通过预先拉取规则信息获取,0代表休息 |
yearmonth | 是 | 排班表月份,格式为年月,如202011 |
权限说明:
仅支持为打卡规则为“按班次上下班”
调用的应用需要满足如下的权限:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「打卡 - 可调用接口的应用」中 |
代开发应用 | 具有「打卡」权限 |
第三方应用 | 具有「打卡」权限 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
调用频率:
接口调用频率限制为60次/分钟。
返回结果:
{
"errcode": 0,
"errmsg": "ok"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 错误码描述 |