获取打卡规则

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckinoption?access_token=ACCESS_TOKEN

请求示例:

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

参数说明:

参数 必须 说明
access_token 调用接口凭证。必须使用打卡应用的Secret获取access_token
datetime 需要获取规则的日期当天0点的Unix时间戳
useridlist 需要获取打卡规则的用户列表
  1. 用户列表不超过100个,若用户超过100个,请分批获取。
  2. 用户在不同日期的规则不一定相同,请按天获取。

返回结果 :

{
    "errcode": 0,
    "errmsg": "ok",
    "info": [
        {
            "userid": "james",
            "group": {
                "grouptype": 1,
                "groupid": 69,
                "checkindate": [
                    {
                        "workdays": [
                            1,
                            2,
                            3,
                            4,
                            5
                        ],
                        "checkintime": [
                            {
                                "work_sec": 36000,
                                "off_work_sec": 43200,
                                "remind_work_sec": 35400,
                                "remind_off_work_sec": 43200
                            },
                            {
                                "work_sec": 50400,
                                "off_work_sec": 72000,
                                "remind_work_sec": 49800,
                                "remind_off_work_sec": 72000
                            }
                        ],
                        "flex_time": 300000,
                        "noneed_offwork": true,
                        "limit_aheadtime": 10800000
                    }
                ],
                "spe_workdays": [
                    {
                        "timestamp": 1512144000,
                        "notes": "必须打卡的日期",
                        "checkintime": [
                            {
                                "work_sec": 32400,
                                "off_work_sec": 61200,
                                "remind_work_sec": 31800,
                                "remind_off_work_sec": 61200
                            }
                        ]
                    }
                ],
                "spe_offdays": [
                    {
                        "timestamp": 1512057600,
                        "notes": "不需要打卡的日期",
                        "checkintime": []
                    }
                ],
                "sync_holidays": true,
                "groupname": "打卡规则1",
                "need_photo": true,
                "wifimac_infos": [
                    {
                        "wifiname": "Tencent-WiFi-1",
                        "wifimac": "c0:7b:bc:37:f8:d3",
                    },
                    {
                        "wifiname": "Tencent-WiFi-2",
                        "wifimac": "70:10:5c:7d:f6:d5",
                    }
                ],
                "note_can_use_local_pic": false,
                "allow_checkin_offworkday": true,
                "allow_apply_offworkday": true,
                "loc_infos": [
                    {
                        "lat": 30547030,
                        "lng": 104062890,
                        "loc_title": "腾讯成都大厦",
                        "loc_detail": "四川省成都市武侯区高新南区天府三街",
                        "distance": 300
                    },
                    {
                        "lat": 23097490,
                        "lng": 113323750,
                        "loc_title": "T.I.T创意园",
                        "loc_detail": "广东省广州市海珠区新港中路397号",
                        "distance": 300
                    }
                ]
            }
        }
    ]
}

参数说明:

参数 说明
userid 用户id
grouptype 打卡规则类型。1:固定时间上下班;2:按班次上下班;3:自由上下班 。
groupid 打卡规则id
groupname 打卡规则名称
checkindate 打卡时间
workdays 工作日。若为固定时间上下班或自由上下班,则1到6分别表示星期一到星期六,0表示星期日;若为按班次上下班,则表示拉取班次的日期。
work_sec 上班时间,表示为距离当天0点的秒数。
off_work_sec 下班时间,表示为距离当天0点的秒数。
remind_work_sec 上班提醒时间,表示为距离当天0点的秒数。
remind_off_work_sec 下班提醒时间,表示为距离当天0点的秒数。
flex_time 弹性时间(毫秒)
noneed_offwork 下班不需要打卡
limit_aheadtime 打卡时间限制(毫秒)
spe_workdays 特殊日期
timestamp 特殊日期具体时间
notes 特殊日期备注
allow_checkin_offworkday 是否非工作日允许打卡
sync_holidays 是否同步法定节假日
need_photo 是否打卡必须拍照
note_can_use_local_pic 是否备注时允许上传本地图片
allow_apply_offworkday 是否允许异常打卡时提交申请
wifimac_infos WiFi打卡地点信息
wifiname WiFi打卡地点名称
wifimac WiFi打卡地点MAC地址/bssid
loc_infos 位置打卡地点信息
lat 位置打卡地点纬度,是实际纬度的1000000倍,与腾讯地图一致采用GCJ-02坐标系统标准
lng 位置打卡地点经度,是实际经度的1000000倍,与腾讯地图一致采用GCJ-02坐标系统标准
loc_title 位置打卡地点名称
loc_detail 位置打卡地点详情
distance 允许打卡范围(米)
© 1998 - 2020 Tencent Inc. All Rights Reserved