cn.felord.reactive.api

Interface ApprovalApi

public interface ApprovalApi

企业微信审批

Since:

2023 /5/25 14:18

Author:

dax

Method Summary

Modifier and Type	Method and Description
io.reactivex.rxjava3.core.Single<GenericResponse<String>>	applyEvent(ApprovalApplyRequest request) 提交审批申请
io.reactivex.rxjava3.core.Single<GenericResponse<String>>	createTemplate(ApprovalTempAddRequest template) 创建审批模板
io.reactivex.rxjava3.core.Single<GenericResponse<ApprovalDetail>>	getApprovalDetail(ApprovalSpNo spNo) 获取审批申请详情 sp_no
io.reactivex.rxjava3.core.Single<SpNoListResponse>	getApprovalInfo(SpNoListRequest request) 批量获取审批单号
GenericResponse<OpenApprovalData>	getOpenApprovalData(ApprovalThirdNo thirdNo) 查询自建应用审批单当前状态
io.reactivex.rxjava3.core.Single<ApprovalTmpDetailResponse>	getTemplateDetail(TemplateId templateId) 获取审批模板详情
io.reactivex.rxjava3.core.Single<GenericResponse<List<VacationQuota>>>	getUserVacationQuota(UserId userId) 获取成员假期余额
io.reactivex.rxjava3.core.Single<WeComResponse>	setOneUserQuota(UserQuotaSettingRequest request) 修改成员假期余额
io.reactivex.rxjava3.core.Single<WeComResponse>	updateTemplate(ApprovalTempUpdateRequest template) 更新审批模板

Method Detail

getTemplateDetail

@POST(value="oa/gettemplatedetail")
io.reactivex.rxjava3.core.Single<ApprovalTmpDetailResponse> getTemplateDetail(@Body
                                                                                                                  TemplateId templateId)

获取审批模板详情

Parameters:

templateId - the template id

Returns:

the detail

createTemplate

@POST(value="oa/approval/create_template")
io.reactivex.rxjava3.core.Single<GenericResponse<String>> createTemplate(@Body
                                                                                                                    ApprovalTempAddRequest template)

创建审批模板

仅『审批』系统应用、自建应用和代开发自建应用可调用。

Parameters:

template - the template

Returns:

the generic response

updateTemplate

@POST(value="oa/approval/update_template")
io.reactivex.rxjava3.core.Single<WeComResponse> updateTemplate(@Body
                                                                                                          ApprovalTempUpdateRequest template)

更新审批模板

可调用本接口更新审批模板。更新模板后，管理后台及审批应用内将更新原模板的内容，已配置的审批流程和规则不变。

• 仅『审批』系统应用，自建应用和代开发自建应用可调用
• 所有应用都可以通过本接口更新自己的模板
• 『审批』系统应用可以修改管理员手动创建的模板
• 自建应用和代开发自建应用不可通过本接口更新其他应用创建的模板

Parameters:

template - the template

Returns:

the we com response

applyEvent

@POST(value="oa/applyevent")
io.reactivex.rxjava3.core.Single<GenericResponse<String>> applyEvent(@Body
                                                                                                  ApprovalApplyRequest request)

提交审批申请

Parameters:

request - the request

Returns:

the generic response

getApprovalInfo

@POST(value="oa/getapprovalinfo")
io.reactivex.rxjava3.core.Single<SpNoListResponse> getApprovalInfo(@Body
                                                                                                     SpNoListRequest request)

批量获取审批单号

一次拉取调用最多拉取100个审批记录，可以通过多次拉取的方式来满足需求。

1. 接口频率限制 600次/分钟
2. 请求的参数endtime需要大于startime， 起始时间跨度不能超过31天

Parameters:

request - the request

Returns:

the sp no list response

getApprovalDetail

@POST(value="oa/getapprovaldetail")
io.reactivex.rxjava3.core.Single<GenericResponse<ApprovalDetail>> getApprovalDetail(@Body
                                                                                                                        ApprovalSpNo spNo)

获取审批申请详情 sp_no

Parameters:

spNo - the sp no

Returns:

sp no list response

getOpenApprovalData

@POST(value="corp/getopenapprovaldata")
GenericResponse<OpenApprovalData> getOpenApprovalData(@Body
                                                                                              ApprovalThirdNo thirdNo)
                                                                                       throws WeComException

查询自建应用审批单当前状态

Parameters:

thirdNo - the third no thirdNo

Returns:

the generic response

Throws:

WeComException - the weComException

getUserVacationQuota

@POST(value="oa/vacation/getuservacationquota")
io.reactivex.rxjava3.core.Single<GenericResponse<List<VacationQuota>>> getUserVacationQuota(@Body
                                                                                                                                            UserId userId)
                                                                                                                                     throws WeComException

获取成员假期余额

数据来源为人事助手-假期管理

Parameters:

userId - the user id

Returns:

the user vacation quota

Throws:

WeComException - the we com exception

setOneUserQuota

@POST(value="oa/vacation/setoneuserquota")
io.reactivex.rxjava3.core.Single<WeComResponse> setOneUserQuota(@Body
                                                                                                           UserQuotaSettingRequest request)
                                                                                                    throws WeComException

修改成员假期余额

Parameters:

request - the request

Returns:

the one user quota

Throws:

WeComException - the we com exception