获取员工打卡规则 - Developer OpenAPI

企业可通过打卡应用Secret获取的token，获取指定员工指定日期的打卡规则。
第三方应用可获取应用可见范围内指定员工指定日期的打卡规则。

用户列表不超过100个，若用户超过100个，请分批获取。
用户在不同日期的规则不一定相同，请按天获取。

文档ID: 14631
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90263
https://open.work.weixin.qq.com/api/doc/90001/90143/94204

请求参数

Query 参数

access_token

string

必需

调用接口凭证。必须使用打卡应用的Secret获取access_token，获取方式参考：文档-获取access_token

示例值:

Body 参数application/json

datetime

integer <int32>

必需

需要获取规则的日期当天0点的Unix时间戳

useridlist

array[string]

必需

需要获取打卡规则的用户列表

示例

{
  "datetime": 1511971200,
  "useridlist": [
    "james",
    "paul"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

errmsg

string

可选

info

array [object {2}]

返回的打卡规则列表

可选

userid

string

可选

打卡人员userid

group

object

打卡规则相关信息

可选

示例

{
  "errcode": 0,
  "errmsg": "string",
  "info": [
    {
      "userid": "string",
      "group": {
        "need_photo": true,
        "checkindate": [
          {
            "workdays": [
              0
            ],
            "flex_on_duty_time": 0,
            "limit_aheadtime": 0,
            "flex_off_duty_time": 0,
            "flex_time": 0,
            "checkintime": [
              {
                "remind_work_sec": 0,
                "off_work_sec": 0,
                "work_sec": 0,
                "remind_off_work_sec": 0
              }
            ],
            "noneed_offwork": true
          }
        ],
        "schedulelist": [
          {
            "limit_offtime": 0,
            "flex_on_duty_time": 0,
            "time_section": [
              {
                "time_id": 0,
                "remind_work_sec": 0,
                "off_work_sec": 0,
                "rest_begin_time": 0,
                "work_sec": 0,
                "remind_off_work_sec": 0,
                "allow_rest": true,
                "rest_end_time": 0
              }
            ],
            "max_allow_arrive_early": 0,
            "limit_aheadtime": 0,
            "flex_off_duty_time": 0,
            "late_rule": {
              "timerules": [
                {
                  "offwork_after_time": 0,
                  "onwork_flex_time": 0
                }
              ],
              "allow_offwork_after_time": true
            },
            "schedule_id": 0,
            "schedule_name": "string",
            "max_allow_arrive_late": 0,
            "noneed_offwork": true,
            "allow_flex": true
          }
        ],
        "groupid": 0,
        "loc_infos": [
          {
            "loc_title": "string",
            "lng": 0,
            "distance": 0,
            "loc_detail": "string",
            "lat": 0
          }
        ],
        "spe_workdays": [
          {
            "notes": "string",
            "checkintime": [
              {
                "remind_work_sec": 0,
                "off_work_sec": 0,
                "work_sec": 0,
                "remind_off_work_sec": 0
              }
            ],
            "timestamp": 0
          }
        ],
        "sync_holidays": true,
        "groupname": "string",
        "allow_checkin_offworkday": true,
        "grouptype": 0,
        "spe_offdays": [
          {
            "notes": "string",
            "checkintime": [
              {}
            ],
            "timestamp": 0
          }
        ],
        "allow_apply_offworkday": true,
        "wifimac_infos": [
          {
            "wifiname": "string",
            "wifimac": "string"
          }
        ],
        "note_can_use_local_pic": true
      }
    }
  ]
}