获取打卡人员排班信息

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

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

useridlist

array[string]

可选

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

endtime

integer <int32>

可选

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

starttime

integer <int32>

可选

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

示例

{
  "starttime": 1492617600,
  "endtime": 1492790400,
  "useridlist": [
    "james",
    "paul"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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

打卡规则名

可选

示例

{
  "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"
    }
  ]
}