com.kdayun.wecom.service

接口 WecomService

所有已知实现类:

WecomServiceImpl

public interface WecomService

方法概要

限定符和类型	方法和说明
void	eventCallback(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, java.lang.String orgCode) 企业微信的事件回调
java.lang.String	getAccessToken() 获取的访问AccessToken
WxCpApprovalDetailResult	getApprovalDetail(@NonNull java.lang.String spNo) 获取审批申请详情 企业可通过审批应用或自建应用Secret调用本接口，根据审批单号查询企业微信“审批应用”的审批申请详情。
WxCpApprovalInfo	getApprovalInfo(@NonNull java.util.Date startTime, @NonNull java.util.Date endTime, java.lang.Integer cursor, java.lang.Integer size, java.util.List<WxCpApprovalInfoQueryFilter> filters) 批量获取审批单号 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
java.util.List<WxCpCheckinData>	getCheckinData(java.lang.Number openCheckinDataType, java.lang.String startTime, java.lang.String endTime, java.lang.String[] userIdList) 获取打卡数据
java.util.List<WxCpCheckinDayData>	getCheckinDayData(java.util.Date startTime, java.util.Date endTime, java.util.List<java.lang.String> userIdList) 获取打卡日报数据
java.util.List<WxCpCheckinMonthData>	getCheckinMonthData(java.util.Date startTime, java.util.Date endTime, java.util.List<java.lang.String> userIdList) 获取打卡月报数据
java.util.List<WxCpCheckinOption>	getCheckinOption(java.lang.String datetime, java.util.List<java.lang.String> userIdList) 获取打卡规则 API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
java.util.List<WxCpCheckinSchedule>	getCheckinScheduleList(java.util.Date startTime, java.util.Date endTime, java.util.List<java.lang.String> userIdList) 获取打卡人员排班信息
WxCpCorpConfInfo	getCorpConf() 获取企业假期管理配置 企业可通过审批应用或自建应用Secret调用本接口，获取可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。
WxCpService	getCpService(java.lang.Boolean isMessageEvent) 获取当前单位对应的agentid的微信服务
java.util.List<WxCpDepart>	getDepartList(java.lang.Long id) 获取部门数据
java.util.List<WxCpDialRecord>	getDialRecord(java.util.Date startTime, java.util.Date endTime, java.lang.Integer offset, java.lang.Integer limit) 获取公费电话拨打记录
WxCpTemplateResult	getTemplateDetail(@NonNull java.lang.String templateId) 获取审批模板详情
java.util.List<WxCpUser>	getUserDtlInfoByDeprtId(java.lang.Long departId, java.lang.Boolean fetchChild, java.lang.Integer status) 获取部门成员详情.
java.util.List<WxCpUser>	getUserInfoByDeprtId(java.lang.Long departId, java.lang.Boolean fetchChild, java.lang.Integer status) 获取部门成员.
WxCpUser	getUserInfoById(java.lang.String userid) 获取用户信息
java.lang.String	refreshAccessToken() 刷新的访问AccessToken 失效时候使用
void	setCheckinScheduleList(WxCpSetCheckinSchedule wxCpSetCheckinSchedule) 为打卡人员排班

方法详细资料

getAccessToken

java.lang.String getAccessToken()
                         throws java.lang.Exception

获取的访问AccessToken

返回:

accesstoken

抛出:

java.lang.Exception - 出错会抛出异常

refreshAccessToken

java.lang.String refreshAccessToken()
                             throws java.lang.Exception

刷新的访问AccessToken 失效时候使用

返回:

AccessToken

抛出:

java.lang.Exception - 出错会抛出异常

getCheckinData

java.util.List<WxCpCheckinData> getCheckinData(java.lang.Number openCheckinDataType,
                                               java.lang.String startTime,
                                               java.lang.String endTime,
                                               java.lang.String[] userIdList)
                                        throws java.lang.Exception

获取打卡数据

参数:

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

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

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

userIdList - 需要获取打卡记录的用户列表 注意这个每次最多能获取100个人的打卡数据 如果需要更多请求分批获取

返回:

打卡数据列表

抛出:

java.lang.Exception - 出错会抛出异常

getCheckinOption

java.util.List<WxCpCheckinOption> getCheckinOption(java.lang.String datetime,
                                                   java.util.List<java.lang.String> userIdList)
                                            throws java.lang.Exception

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

参数:

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

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

返回:

打卡规则列表 checkin option

抛出:

java.lang.Exception - 出错会抛出异常

getDepartList

java.util.List<WxCpDepart> getDepartList(java.lang.Long id)
                                  throws java.lang.Exception

获取部门数据

参数:

id - 部门id。获取指定部门及其下的子部门。非必需，可为null

返回:

获取的部门列表

抛出:

java.lang.Exception - 出错会抛出异常

getUserInfoById

WxCpUser getUserInfoById(java.lang.String userid)
                  throws java.lang.Exception

获取用户信息

参数:

userid - 用户id

返回:

the by id

抛出:

java.lang.Exception - 出错会抛出异常

getUserInfoByDeprtId

java.util.List<WxCpUser> getUserInfoByDeprtId(java.lang.Long departId,
                                              java.lang.Boolean fetchChild,
                                              java.lang.Integer status)
                                       throws java.lang.Exception

获取部门成员. http://qydev.weixin.qq.com/wiki/index.php?title=管理成员#.E8.8E.B7.E5.8F.96.E9.83.A8.E9.97.A8.E6.88.90.E5.91.98

参数:

departId - 必填。部门id

fetchChild - 非必填。获取方式: 1/0：是否递归获取子部门下面的成员

status - 非必填。员工的状态: 0获取全部员工，1获取已关注成员列表，2获取禁用成员列表，4获取未关注成员列表。status可叠加

返回:

the list

抛出:

java.lang.Exception - 出错会抛出异常

getUserDtlInfoByDeprtId

java.util.List<WxCpUser> getUserDtlInfoByDeprtId(java.lang.Long departId,
                                                 java.lang.Boolean fetchChild,
                                                 java.lang.Integer status)
                                          throws java.lang.Exception

获取部门成员详情. https://work.weixin.qq.com/api/doc/90000/90135/90201

参数:

departId - 必填。部门id

fetchChild - 非必填。获取方式: 1/0：是否递归获取子部门下面的成员

status - 非必填。员工的状态: 0获取全部员工，1获取已关注成员列表，2获取禁用成员列表，4获取未关注成员列表。status可叠加

返回:

the list

抛出:

java.lang.Exception - 出错会抛出异常

getApprovalDetail

WxCpApprovalDetailResult getApprovalDetail(@NonNull
                                           @NonNull java.lang.String spNo)
                                    throws java.lang.Exception

   获取审批申请详情

   企业可通过审批应用或自建应用Secret调用本接口，根据审批单号查询企业微信“审批应用”的审批申请详情。

   API Doc : https://work.weixin.qq.com/api/doc/90000/90135/91983
 

参数:

spNo - 审批单编号。

返回:

WxCpApprovaldetail approval detail

抛出:

java.lang.Exception - 出错会抛出异常 .

getCorpConf

WxCpCorpConfInfo getCorpConf()
                      throws java.lang.Exception

获取企业假期管理配置 企业可通过审批应用或自建应用Secret调用本接口，获取可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。 第三方应用可获取应用可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。 请求方式：GET(HTTPS) 请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/getcorpconf?access_token=ACCESS_TOKEN

返回:

WxCpCorpConfInfo

抛出:

java.lang.Exception - 出错会抛出异常

getDialRecord

java.util.List<WxCpDialRecord> getDialRecord(java.util.Date startTime,
                                             java.util.Date endTime,
                                             java.lang.Integer offset,
                                             java.lang.Integer limit)
                                      throws java.lang.Exception

获取公费电话拨打记录

参数:

startTime - 查询的起始时间戳

endTime - 查询的结束时间戳

offset - 分页查询的偏移量

limit - 分页查询的每页大小,默认为100条，如该参数大于100则按100处理

返回:

. dial record

抛出:

java.lang.Exception - 出错会抛出异常 .

getTemplateDetail

WxCpTemplateResult getTemplateDetail(@NonNull
                                     @NonNull java.lang.String templateId)
                              throws java.lang.Exception

获取审批模板详情

参数:

templateId - 模板ID

返回:

. template detail

抛出:

java.lang.Exception - 出错会抛出异常 .

getCheckinDayData

java.util.List<WxCpCheckinDayData> getCheckinDayData(java.util.Date startTime,
                                                     java.util.Date endTime,
                                                     java.util.List<java.lang.String> userIdList)
                                              throws java.lang.Exception

获取打卡日报数据

参数:

startTime - 获取日报的开始时间

endTime - 获取日报的结束时间

userIdList - 获取日报的userid列表

返回:

日报数据列表 checkin day data

抛出:

java.lang.Exception - 出错会抛出异常 the wx error exception

getCheckinMonthData

java.util.List<WxCpCheckinMonthData> getCheckinMonthData(java.util.Date startTime,
                                                         java.util.Date endTime,
                                                         java.util.List<java.lang.String> userIdList)
                                                  throws java.lang.Exception

获取打卡月报数据

参数:

startTime - 获取月报的开始时间

endTime - 获取月报的结束时间

userIdList - 获取月报的userid列表

返回:

月报数据列表

抛出:

java.lang.Exception - 出错会抛出异常 the wx error exception

getCheckinScheduleList

java.util.List<WxCpCheckinSchedule> getCheckinScheduleList(java.util.Date startTime,
                                                           java.util.Date endTime,
                                                           java.util.List<java.lang.String> userIdList)
                                                    throws java.lang.Exception

获取打卡人员排班信息

参数:

startTime - 获取排班信息的开始时间。Unix时间戳

endTime - 获取排班信息的结束时间。Unix时间戳（与starttime跨度不超过一个月）

userIdList - 需要获取排班信息的用户列表（不超过100个）

返回:

排班表信息

抛出:

java.lang.Exception - 出错会抛出异常 the wx error exception

setCheckinScheduleList

void setCheckinScheduleList(WxCpSetCheckinSchedule wxCpSetCheckinSchedule)
                     throws java.lang.Exception

为打卡人员排班

参数:

wxCpSetCheckinSchedule - the wx cp set checkin schedule

抛出:

java.lang.Exception - 出错会抛出异常 the wx error exception

getApprovalInfo

WxCpApprovalInfo getApprovalInfo(@NonNull
                                 @NonNull java.util.Date startTime,
                                 @NonNull
                                 @NonNull java.util.Date endTime,
                                 java.lang.Integer cursor,
                                 java.lang.Integer size,
                                 java.util.List<WxCpApprovalInfoQueryFilter> filters)
                          throws java.lang.Exception

 批量获取审批单号

 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
 自建应用调用此接口，需在“管理后台-应用管理-审批-API-审批数据权限”中，授权应用允许提交审批单据。

 一次拉取调用最多拉取100个审批记录，可以通过多次拉取的方式来满足需求，但调用频率不可超过600次/分。

 API doc : https://work.weixin.qq.com/api/doc/90000/90135/91816
 

参数:

startTime - 开始时间

endTime - 结束时间

cursor - 分页查询游标，默认为0，后续使用返回的next_cursor进行分页拉取

size - 一次请求拉取审批单数量，默认值为100，上限值为100

filters - 筛选条件，可对批量拉取的审批申请设置约束条件，支持设置多个条件,nullable

返回:

WxCpApprovalInfo approval info

抛出:

java.lang.Exception - 出错会抛出异常

getCpService

WxCpService getCpService(java.lang.Boolean isMessageEvent)
                  throws java.lang.Exception

获取当前单位对应的agentid的微信服务

参数:

isMessageEvent - 是否消息的回调如果是允许agentid为空

返回:

WxCpService

抛出:

java.lang.Exception - 出错会抛出异常

eventCallback

void eventCallback(javax.servlet.http.HttpServletRequest request,
                   javax.servlet.http.HttpServletResponse response,
                   java.lang.String orgCode)
            throws java.lang.Exception

企业微信的事件回调

参数:

request - 请求对象

response - 相应对象

orgCode - 机构编码

抛出:

java.lang.Exception - 出错会抛出异常