第三方应用开发 服务端API 打卡 为打卡人员排班
为打卡人员排班
最后更新:2023/12/18
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
为打卡人员排班
最后更新:2023/12/18

企业可通过具有调用权限的应用,为打卡规则为“按班次上下班”规则的指定员工排班。

 

请求方式: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"
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
上一篇
获取打卡人员排班信息
下一篇
获取设备打卡数据