mirror of
https://github.com/silenceper/wechat.git
synced 2026-02-04 12:52:27 +08:00
feat:企业微信-打卡-新增相关查询接口 (#746)
Co-authored-by: markwang <www.wang61@qq.com>
This commit is contained in:
markwang
GitHub
@@ -13,6 +13,14 @@ const (
|
||||
getDayDataURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckin_daydata?access_token=%s"
|
||||
// getMonthDataURL 获取打卡月报数据
|
||||
getMonthDataURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckin_monthdata?access_token=%s"
|
||||
// getCorpOptionURL 获取企业所有打卡规则
|
||||
getCorpOptionURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcorpcheckinoption?access_token=%s"
|
||||
// getOptionURL 获取员工打卡规则
|
||||
getOptionURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckinoption?access_token=%s"
|
||||
// getScheduleListURL 获取打卡人员排班信息
|
||||
getScheduleListURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckinschedulist?access_token=%s"
|
||||
// getHardwareDataURL获取设备打卡数据
|
||||
getHardwareDataURL = "https://qyapi.weixin.qq.com/cgi-bin/hardware/get_hardware_checkin_data?access_token=%s"
|
||||
)
|
||||
|
||||
type (
|
||||
@@ -257,3 +265,396 @@ func (r *Client) GetMonthData(req *GetCheckinDataRequest) (result *GetMonthDataR
|
||||
err = util.DecodeWithError(response, result, "GetMonthData")
|
||||
return
|
||||
}
|
||||
|
||||
// GetCorpOptionResponse 获取企业所有打卡规则响应
|
||||
type GetCorpOptionResponse struct {
|
||||
util.CommonError
|
||||
Group []CorpOptionGroup `json:"group"`
|
||||
}
|
||||
|
||||
// CorpOptionGroup 企业规则信息列表
|
||||
type CorpOptionGroup struct {
|
||||
GroupType int64 `json:"grouptype"`
|
||||
GroupID int64 `json:"groupid"`
|
||||
GroupName string `json:"groupname"`
|
||||
CheckinDate []GroupCheckinDate `json:"checkindate"`
|
||||
SpeWorkdays []SpeWorkdays `json:"spe_workdays"`
|
||||
SpeOffDays []SpeOffDays `json:"spe_offdays"`
|
||||
SyncHolidays bool `json:"sync_holidays"`
|
||||
NeedPhoto bool `json:"need_photo"`
|
||||
NoteCanUseLocalPic bool `json:"note_can_use_local_pic"`
|
||||
AllowCheckinOffWorkday bool `json:"allow_checkin_offworkday"`
|
||||
AllowApplyOffWorkday bool `json:"allow_apply_offworkday"`
|
||||
WifiMacInfos []WifiMacInfos `json:"wifimac_infos"`
|
||||
LocInfos []LocInfos `json:"loc_infos"`
|
||||
Range []Range `json:"range"`
|
||||
CreateTime int64 `json:"create_time"`
|
||||
WhiteUsers []string `json:"white_users"`
|
||||
Type int64 `json:"type"`
|
||||
ReporterInfo ReporterInfo `json:"reporterinfo"`
|
||||
OtInfo GroupOtInfo `json:"ot_info"`
|
||||
OtApplyInfo OtApplyInfo `json:"otapplyinfo"`
|
||||
Uptime int64 `json:"uptime"`
|
||||
AllowApplyBkCnt int64 `json:"allow_apply_bk_cnt"`
|
||||
OptionOutRange int64 `json:"option_out_range"`
|
||||
CreateUserID string `json:"create_userid"`
|
||||
UseFaceDetect bool `json:"use_face_detect"`
|
||||
AllowApplyBkDayLimit int64 `json:"allow_apply_bk_day_limit"`
|
||||
UpdateUserID string `json:"update_userid"`
|
||||
BukaRestriction int64 `json:"buka_restriction"`
|
||||
ScheduleList []ScheduleList `json:"schedulelist"`
|
||||
OffWorkIntervalTime int64 `json:"offwork_interval_time"`
|
||||
}
|
||||
|
||||
// GroupCheckinDate 打卡时间，当规则类型为排班时没有意义
|
||||
type GroupCheckinDate struct {
|
||||
Workdays []int64 `json:"workdays"`
|
||||
CheckinTime []GroupCheckinTime `json:"checkintime"`
|
||||
NoNeedOffWork bool `json:"noneed_offwork"`
|
||||
LimitAheadTime int64 `json:"limit_aheadtime"`
|
||||
FlexOnDutyTime int64 `json:"flex_on_duty_time"`
|
||||
FlexOffDutyTime int64 `json:"flex_off_duty_time"`
|
||||
}
|
||||
|
||||
// GroupCheckinTime 工作日上下班打卡时间信息
|
||||
type GroupCheckinTime struct {
|
||||
WorkSec int64 `json:"work_sec"`
|
||||
OffWorkSec int64 `json:"off_work_sec"`
|
||||
RemindWorkSec int64 `json:"remind_work_sec"`
|
||||
RemindOffWorkSec int64 `json:"remind_off_work_sec"`
|
||||
}
|
||||
|
||||
// SpeWorkdays 特殊日期-必须打卡日期信息
|
||||
type SpeWorkdays struct {
|
||||
Timestamp int64 `json:"timestamp"`
|
||||
Notes string `json:"notes"`
|
||||
CheckinTime []GroupCheckinTime `json:"checkintime"`
|
||||
}
|
||||
|
||||
// SpeOffDays 特殊日期-不用打卡日期信息
|
||||
type SpeOffDays struct {
|
||||
Timestamp int64 `json:"timestamp"`
|
||||
Notes string `json:"notes"`
|
||||
}
|
||||
|
||||
// WifiMacInfos 打卡地点-WiFi打卡信息
|
||||
type WifiMacInfos struct {
|
||||
WifiName string `json:"wifiname"`
|
||||
WifiMac string `json:"wifimac"`
|
||||
}
|
||||
|
||||
// LocInfos 打卡地点-位置打卡信息
|
||||
type LocInfos struct {
|
||||
Lat int64 `json:"lat"`
|
||||
Lng int64 `json:"lng"`
|
||||
LocTitle string `json:"loc_title"`
|
||||
LocDetail string `json:"loc_detail"`
|
||||
Distance int64 `json:"distance"`
|
||||
}
|
||||
|
||||
// Range 打卡人员信息
|
||||
type Range struct {
|
||||
PartyID []string `json:"partyid"`
|
||||
UserID []string `json:"userid"`
|
||||
TagID []int64 `json:"tagid"`
|
||||
}
|
||||
|
||||
// ReporterInfo 汇报对象信息
|
||||
type ReporterInfo struct {
|
||||
Reporters []Reporters `json:"reporters"`
|
||||
UpdateTime int64 `json:"updatetime"`
|
||||
}
|
||||
|
||||
// Reporters 汇报对象，每个汇报人用userid表示
|
||||
type Reporters struct {
|
||||
UserID string `json:"userid"`
|
||||
}
|
||||
|
||||
// GroupOtInfo 加班信息
|
||||
type GroupOtInfo struct {
|
||||
Type int64 `json:"type"`
|
||||
AllowOtWorkingDay bool `json:"allow_ot_workingday"`
|
||||
AllowOtNonWorkingDay bool `json:"allow_ot_nonworkingday"`
|
||||
OtCheckInfo OtCheckInfo `json:"otcheckinfo"`
|
||||
}
|
||||
|
||||
// OtCheckInfo 以打卡时间为准-加班时长计算规则信息
|
||||
type OtCheckInfo struct {
|
||||
OtWorkingDayTimeStart int64 `json:"ot_workingday_time_start"`
|
||||
OtWorkingDayTimeMin int64 `json:"ot_workingday_time_min"`
|
||||
OtWorkingDayTimeMax int64 `json:"ot_workingday_time_max"`
|
||||
OtNonworkingDayTimeMin int64 `json:"ot_nonworkingday_time_min"`
|
||||
OtNonworkingDayTimeMax int64 `json:"ot_nonworkingday_time_max"`
|
||||
OtNonworkingDaySpanDayTime int64 `json:"ot_nonworkingday_spanday_time"`
|
||||
OtWorkingDayRestInfo OtRestInfo `json:"ot_workingday_restinfo"`
|
||||
OtNonWorkingDayRestInfo OtRestInfo `json:"ot_nonworkingday_restinfo"`
|
||||
}
|
||||
|
||||
// OtRestInfo 加班-休息扣除配置信息
|
||||
type OtRestInfo struct {
|
||||
Type int64 `json:"type"`
|
||||
FixTimeRule FixTimeRule `json:"fix_time_rule"`
|
||||
CalOtTimeRule CalOtTimeRule `json:"cal_ottime_rule"`
|
||||
}
|
||||
|
||||
// FixTimeRule 工作日加班-指定休息时间配置信息
|
||||
type FixTimeRule struct {
|
||||
FixTimeBeginSec int64 `json:"fix_time_begin_sec"`
|
||||
FixTimeEndSec int64 `json:"fix_time_end_sec"`
|
||||
}
|
||||
|
||||
// CalOtTimeRule 工作日加班-按加班时长扣除配置信息
|
||||
type CalOtTimeRule struct {
|
||||
Items []CalOtTimeRuleItem `json:"items"`
|
||||
}
|
||||
|
||||
// CalOtTimeRuleItem 工作日加班-按加班时长扣除条件信息
|
||||
type CalOtTimeRuleItem struct {
|
||||
OtTime int64 `json:"ot_time"`
|
||||
RestTime int64 `json:"rest_time"`
|
||||
}
|
||||
|
||||
// OtApplyInfo 以加班申请核算打卡记录相关信息
|
||||
type OtApplyInfo struct {
|
||||
AllowOtWorkingDay bool `json:"allow_ot_workingday"`
|
||||
AllowOtNonWorkingDay bool `json:"allow_ot_nonworkingday"`
|
||||
Uiptime int64 `json:"uptime"`
|
||||
OtNonworkingDaySpanDayTime int64 `json:"ot_nonworkingday_spanday_time"`
|
||||
OtWorkingDayRestInfo OtRestInfo `json:"ot_workingday_restinfo"`
|
||||
OtNonWorkingDayRestInfo OtRestInfo `json:"ot_nonworkingday_restinfo"`
|
||||
}
|
||||
|
||||
// ScheduleList 排班信息列表
|
||||
type ScheduleList struct {
|
||||
ScheduleID int64 `json:"schedule_id"`
|
||||
ScheduleName string `json:"schedule_name"`
|
||||
TimeSection []TimeSection `json:"time_section"`
|
||||
LimitAheadTime int64 `json:"limit_aheadtime"`
|
||||
NoNeedOffWork bool `json:"noneed_offwork"`
|
||||
LimitOffTime int64 `json:"limit_offtime"`
|
||||
FlexOnDutyTime int64 `json:"flex_on_duty_time"`
|
||||
FlexOffDutyTime int64 `json:"flex_off_duty_time"`
|
||||
AllowFlex bool `json:"allow_flex"`
|
||||
LateRule LateRule `json:"late_rule"`
|
||||
MaxAllowArriveEarly int64 `json:"max_allow_arrive_early"`
|
||||
MaxAllowArriveLate int64 `json:"max_allow_arrive_late"`
|
||||
}
|
||||
|
||||
// TimeSection 班次上下班时段信息
|
||||
type TimeSection struct {
|
||||
TimeID int64 `json:"time_id"`
|
||||
WorkSec int64 `json:"work_sec"`
|
||||
OffWorkSec int64 `json:"off_work_sec"`
|
||||
RemindWorkSec int64 `json:"remind_work_sec"`
|
||||
RemindOffWorkSec int64 `json:"remind_off_work_sec"`
|
||||
RestBeginTime int64 `json:"rest_begin_time"`
|
||||
RestEndTime int64 `json:"rest_end_time"`
|
||||
AllowRest bool `json:"allow_rest"`
|
||||
}
|
||||
|
||||
// LateRule 晚走晚到时间规则信息
|
||||
type LateRule struct {
|
||||
AllowOffWorkAfterTime bool `json:"allow_offwork_after_time"`
|
||||
TimeRules []TimeRule `json:"timerules"`
|
||||
}
|
||||
|
||||
// TimeRule 迟到规则时间
|
||||
type TimeRule struct {
|
||||
OffWorkAfterTime int64 `json:"offwork_after_time"`
|
||||
OnWorkFlexTime int64 `json:"onwork_flex_time"`
|
||||
}
|
||||
|
||||
// GetCorpOption 获取企业所有打卡规则
|
||||
// @see https://developer.work.weixin.qq.com/document/path/93384
|
||||
func (r *Client) GetCorpOption() (*GetCorpOptionResponse, error) {
|
||||
var (
|
||||
accessToken string
|
||||
err error
|
||||
)
|
||||
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
var response []byte
|
||||
if response, err = util.HTTPPost(fmt.Sprintf(getCorpOptionURL, accessToken), ""); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
result := &GetCorpOptionResponse{}
|
||||
err = util.DecodeWithError(response, result, "GetCorpOption")
|
||||
return result, err
|
||||
}
|
||||
|
||||
// GetOptionRequest 获取员工打卡规则请求
|
||||
type GetOptionRequest struct {
|
||||
Datetime int64 `json:"datetime"`
|
||||
UserIDList []string `json:"useridlist"`
|
||||
}
|
||||
|
||||
// GetOptionResponse 获取员工打卡规则响应
|
||||
type GetOptionResponse struct {
|
||||
util.CommonError
|
||||
Info []OptionInfo `json:"info"`
|
||||
}
|
||||
|
||||
// OptionInfo 打卡规则列表
|
||||
type OptionInfo struct {
|
||||
UserID string `json:"userid"`
|
||||
Group OptionGroup `json:"group"`
|
||||
}
|
||||
|
||||
// OptionGroup 打卡规则相关信息
|
||||
type OptionGroup struct {
|
||||
GroupType int64 `json:"grouptype"`
|
||||
GroupID int64 `json:"groupid"`
|
||||
GroupName string `json:"groupname"`
|
||||
CheckinDate []OptionCheckinDate `json:"checkindate"`
|
||||
SpeWorkdays []SpeWorkdays `json:"spe_workdays"`
|
||||
SpeOffDays []SpeOffDays `json:"spe_offdays"`
|
||||
SyncHolidays bool `json:"sync_holidays"`
|
||||
NeedPhoto bool `json:"need_photo"`
|
||||
WifiMacInfos []WifiMacInfos `json:"wifimac_infos"`
|
||||
NoteCanUseLocalPic bool `json:"note_can_use_local_pic"`
|
||||
AllowCheckinOffWorkday bool `json:"allow_checkin_offworkday"`
|
||||
AllowApplyOffWorkday bool `json:"allow_apply_offworkday"`
|
||||
LocInfos []LocInfos `json:"loc_infos"`
|
||||
ScheduleList []ScheduleList `json:"schedulelist"`
|
||||
BukaRestriction int64 `json:"buka_restriction"`
|
||||
}
|
||||
|
||||
// OptionCheckinDate 打卡时间配置
|
||||
type OptionCheckinDate struct {
|
||||
Workdays []int64 `json:"workdays"`
|
||||
CheckinTime []GroupCheckinTime `json:"checkintime"`
|
||||
FlexTime int64 `json:"flex_time"`
|
||||
NoNeedOffWork bool `json:"noneed_offwork"`
|
||||
LimitAheadTime int64 `json:"limit_aheadtime"`
|
||||
FlexOnDutyTime int64 `json:"flex_on_duty_time"`
|
||||
FlexOffDutyTime int64 `json:"flex_off_duty_time"`
|
||||
}
|
||||
|
||||
// GetOption 获取员工打卡规则
|
||||
// see https://developer.work.weixin.qq.com/document/path/90263
|
||||
func (r *Client) GetOption(req *GetOptionRequest) (*GetOptionResponse, error) {
|
||||
var (
|
||||
accessToken string
|
||||
err error
|
||||
)
|
||||
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
var response []byte
|
||||
if response, err = util.PostJSON(fmt.Sprintf(getOptionURL, accessToken), req); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
result := &GetOptionResponse{}
|
||||
err = util.DecodeWithError(response, result, "GetOption")
|
||||
return result, err
|
||||
}
|
||||
|
||||
// GetScheduleListRequest 获取打卡人员排班信息请求
|
||||
type GetScheduleListRequest struct {
|
||||
StartTime int64 `json:"starttime"`
|
||||
EndTime int64 `json:"endtime"`
|
||||
UserIDList []string `json:"useridlist"`
|
||||
}
|
||||
|
||||
// GetScheduleListResponse 获取打卡人员排班信息响应
|
||||
type GetScheduleListResponse struct {
|
||||
util.CommonError
|
||||
ScheduleList []ScheduleItem `json:"schedule_list"`
|
||||
}
|
||||
|
||||
// ScheduleItem 排班表信息
|
||||
type ScheduleItem struct {
|
||||
UserID string `json:"userid"`
|
||||
YearMonth int64 `json:"yearmonth"`
|
||||
GroupID int64 `json:"groupid"`
|
||||
GroupName string `json:"groupname"`
|
||||
Schedule Schedule `json:"schedule"`
|
||||
}
|
||||
|
||||
// Schedule 个人排班信息
|
||||
type Schedule struct {
|
||||
ScheduleList []ScheduleListItem `json:"scheduleList"`
|
||||
}
|
||||
|
||||
// ScheduleListItem 个人排班表信息
|
||||
type ScheduleListItem struct {
|
||||
Day int64 `json:"day"`
|
||||
ScheduleInfo ScheduleInfo `json:"schedule_info"`
|
||||
}
|
||||
|
||||
// ScheduleInfo 个人当日排班信息
|
||||
type ScheduleInfo struct {
|
||||
ScheduleID int64 `json:"schedule_id"`
|
||||
ScheduleName string `json:"schedule_name"`
|
||||
TimeSection []ScheduleTimeSection `json:"time_section"`
|
||||
}
|
||||
|
||||
// ScheduleTimeSection 班次上下班时段信息
|
||||
type ScheduleTimeSection struct {
|
||||
ID int64 `json:"id"`
|
||||
WorkSec int64 `json:"work_sec"`
|
||||
OffWorkSec int64 `json:"off_work_sec"`
|
||||
RemindWorkSec int64 `json:"remind_work_sec"`
|
||||
RemindOffWorkSec int64 `json:"remind_off_work_sec"`
|
||||
}
|
||||
|
||||
// GetScheduleList 获取打卡人员排班信息
|
||||
// see https://developer.work.weixin.qq.com/document/path/93380
|
||||
func (r *Client) GetScheduleList(req *GetScheduleListRequest) (*GetScheduleListResponse, error) {
|
||||
var (
|
||||
accessToken string
|
||||
err error
|
||||
)
|
||||
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
var response []byte
|
||||
if response, err = util.PostJSON(fmt.Sprintf(getScheduleListURL, accessToken), req); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
result := &GetScheduleListResponse{}
|
||||
err = util.DecodeWithError(response, result, "GetScheduleList")
|
||||
return result, err
|
||||
}
|
||||
|
||||
// GetHardwareDataRequest 获取设备打卡数据请求
|
||||
type GetHardwareDataRequest struct {
|
||||
FilterType int64 `json:"filter_type"`
|
||||
StartTime int64 `json:"starttime"`
|
||||
EndTime int64 `json:"endtime"`
|
||||
UserIDList []string `json:"useridlist"`
|
||||
}
|
||||
|
||||
// GetHardwareDataResponse 获取设备打卡数据响应
|
||||
type GetHardwareDataResponse struct {
|
||||
util.CommonError
|
||||
CheckinData []HardwareCheckinData `json:"checkindata"`
|
||||
}
|
||||
|
||||
// HardwareCheckinData 设备打卡数据
|
||||
type HardwareCheckinData struct {
|
||||
UserID string `json:"userid"`
|
||||
CheckinTime int64 `json:"checkin_time"`
|
||||
DeviceSn string `json:"device_sn"`
|
||||
DeviceName string `json:"device_name"`
|
||||
}
|
||||
|
||||
// GetHardwareData 获取设备打卡数据
|
||||
// see https://developer.work.weixin.qq.com/document/path/94126
|
||||
func (r *Client) GetHardwareData(req *GetHardwareDataRequest) (*GetHardwareDataResponse, error) {
|
||||
var (
|
||||
accessToken string
|
||||
err error
|
||||
)
|
||||
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
var response []byte
|
||||
if response, err = util.PostJSON(fmt.Sprintf(getHardwareDataURL, accessToken), req); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
result := &GetHardwareDataResponse{}
|
||||
err = util.DecodeWithError(response, result, "GetHardwareData")
|
||||
return result, err
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user