me.chanjar.weixin.cp.api

接口 WxCpOaService

所有已知实现类:

WxCpOaServiceImpl

public interface WxCpOaService

企业微信OA相关接口.

作者:

Element

方法概要

限定符和类型	方法和说明
WxCpApprovalDataResult	getApprovalData(Date startTime, Date endTime, Long nextSpnum) 获取审批数据 通过本接口来获取公司一段时间内的审批记录。
List<WxCpCheckinData>	getCheckinData(Integer openCheckinDataType, Date startTime, Date endTime, List<String> userIdList) 获取打卡数据 API doc : https://work.weixin.qq.com/api/doc#90000/90135/90262
List<WxCpCheckinOption>	getCheckinOption(Date datetime, List<String> userIdList) 获取打卡规则 API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
List<WxCpDialRecord>	getDialRecord(Date startTime, Date endTime, Integer offset, Integer limit)

方法详细资料

getCheckinData

List<WxCpCheckinData> getCheckinData(Integer openCheckinDataType,
                                     Date startTime,
                                     Date endTime,
                                     List<String> userIdList)
                              throws WxErrorException

  获取打卡数据
  API doc : https://work.weixin.qq.com/api/doc#90000/90135/90262
 

参数:

openCheckinDataType - 打卡类型。1：上下班打卡；2：外出打卡；3：全部打卡

startTime - 获取打卡记录的开始时间

endTime - 获取打卡记录的结束时间

userIdList - 需要获取打卡记录的用户列表

返回:

打卡数据列表

抛出:

WxErrorException - 异常

getCheckinOption

List<WxCpCheckinOption> getCheckinOption(Date datetime,
                                         List<String> userIdList)
                                  throws WxErrorException

   获取打卡规则
   API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
 

参数:

datetime - 需要获取规则的当天日期

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

返回:

打卡规则列表

抛出:

WxErrorException - 异常

getApprovalData

WxCpApprovalDataResult getApprovalData(Date startTime,
                                       Date endTime,
                                       Long nextSpnum)
                                throws WxErrorException

   获取审批数据
   通过本接口来获取公司一段时间内的审批记录。一次拉取调用最多拉取10000个审批记录，可以通过多次拉取的方式来满足需求，但调用频率不可超过600次/分。
   API doc : https://work.weixin.qq.com/api/doc#90000/90135/91530
 

参数:

startTime - 获取审批记录的开始时间

endTime - 获取审批记录的结束时间

nextSpnum - 第一个拉取的审批单号，不填从该时间段的第一个审批单拉取

抛出:

WxErrorException - 异常

getDialRecord

List<WxCpDialRecord> getDialRecord(Date startTime,
                                   Date endTime,
                                   Integer offset,
                                   Integer limit)
                            throws WxErrorException

抛出:

WxErrorException