为打卡人员排班

POST

http://127.0.0.1/cgi-bin/checkin/setcheckinschedulist

第三方应用开发/OA/打卡

最后修改时间：2022-08-30 03:03:37

责任人：未设置

企业可通过打卡应用Secret调用本接口，获取打卡规则为“按班次上下班”规则的指定员工指定时间段内的排班信息。
第三方应用获取应用可见范围内、打卡规则为“按班次上下班”规则的指定员工指定时间段内的排班信息。
权限说明: (无特殊权限)
仅支持为打卡规则为“按班次上下班”

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

文档ID: 25766
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93385
https://open.work.weixin.qq.com/api/doc/90001/90143/94209

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

groupid

integer <int32>

可选

打卡规则的规则id，可通过“获取打卡规则”、“获取打卡数据”、“获取打卡人员排班信息”等相关接口获取

yearmonth

integer <int32>

可选

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

items

array [object {3}]

排班表信息

可选

userid

string

可选

打卡人员userid

day

integer <int32>

可选

要设置的天日期，取值在1-31之间。联合yearmonth组成唯一日期比如20201205

schedule_id

integer <int32>

可选

对应groupid规则下的班次id，通过预先拉取规则信息获取，0代表休息

示例

{
  "groupid": 226,
  "items": [
    {
      "userid": "james",
      "day": 5,
      "schedule_id": 234
    }
  ],
  "yearmonth": 202012
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/checkin/setcheckinschedulist?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "groupid": 226,
    "items": [
        {
            "userid": "james",
            "day": 5,
            "schedule_id": 234
        }
    ],
    "yearmonth": 202012
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

errmsg

string

可选

示例

{
  "errcode": 0,
  "errmsg": "string"
}

获取打卡人员排班信息