。

因此无需引入Maven依赖#xff0c;直接以Https方式请求即可。

基础配置

企业微信官方提供的均为API接口没有提供集成SDK。

因此无需引入Maven依赖直接以Https方式请求即可。

基础配置

企业微信注册后可得到corpId、agentId、corpSecret的信息。

而企业微信的所有接口均以https://qyapi.weixin.qq.com/cgi-bin开头。

综上在yml中定义配置

https://qyapi.weixin.qq.com/cgi-bincorpId:

1000000corpSecret:

V0000000000_00000000000000000000000000000wc然后定义一个配置类

import

org.springframework.boot.context.properties.ConfigurationProperties;

import

org.springframework.context.annotation.Configuration;

import

org.springframework.stereotype.Component;Component

Configuration

服务端需要向企业微信发送请求。

这里使用Forest来进行请求。

首先引入依赖

dependencygroupIdcom.dtflys.forest/groupIdartifactIdforest-spring-boot-starter/artifactIdversion1.5.32/version

/dependency考虑到所有的请求都需拼接共同的企业微信请求地址因此为Forest添加拦截器来统一处理

import

com.dtflys.forest.http.ForestRequest;

import

com.dtflys.forest.interceptor.Interceptor;

import

com.dtflys.forest.reflection.ForestMethod;

import

org.springframework.beans.factory.annotation.Autowired;

import

org.springframework.stereotype.Component;Component

public

{req.setBasePath(qywxConfig.getEndpoint());}

import

com.cosmoplat.hyida.core.result.Result;

import

com.cosmoplat.qingyin.safety.qywx.controller.model.dto.MessageTextDto;

import

com.cosmoplat.qingyin.safety.qywx.controller.model.dto.QyWxUserDetailDto;

import

com.cosmoplat.qingyin.safety.qywx.inteceptor.SafetyForestInterceptor;

import

com.dtflys.forest.annotation.*;import

java.util.Map;BaseRequest(interceptor

headers

/gettoken?corpid{corpId}corpsecret{corpSecret})MapString,Object

getToken(Var(corpId)

corpSecret);}当调用时引入QywxConfig和QywxForestClient

Resource

qywxConfig.getCorpSecret();MapString,

Object

qywxForestClient.getToken(corpId,

corpSecret);if

(!result.get(errcode).equals(0)

StringUtils.isEmpty(result.get(access_token)))

{System.out.println(获取企业微信access_token失败!

result.get(errmsg));

String.valueOf(result.get(access_token));

}关于access_token

https://developer.work.weixin.qq.com/document/path/91039

access_token

返回给前端需要开发者保存在后台所有访问企业微信api的请求由后台发起。

开发者需要缓存access_token用于后续接口的调用注意不能频繁调用gettoken接口否则会受到频率拦截。

当access_token失效或过期时需要重新获取。

access_token的有效期通过返回的expires_in来传达正常情况下为7200秒2小时有效期内重复获取返回相同结果过期后获取会返回新的access_token。

因此最佳实践应使用Redis缓存access_token。

当获取access_token时先从Redis中取。

若取不到则向企业微信发起请求获取并写入到Redis中。

携带参数

https://qyapi.weixin.qq.com/cgi-bin/message/send?access_tokenACCESS_TOKEN

参数示例为

UserID1|UserID2|UserID3,toparty

TagID1

href\http://work.weixin.qq.com\邮件中心视频实况/a聪明避开排队。

},safe:0,enable_id_trans:

1800

首先定义一个MessageTextDto对象来承载发送时的参数。

其中text属性又是一个对象。

import

io.swagger.annotations.ApiModel;

import

指定接收消息的成员成员ID列表多个接收者用‘|’分隔最多支持1000个。

*

特殊情况指定为all则向该企业应用的全部成员发送*/private

String

指定接收消息的部门部门ID列表多个接收者用‘|’分隔最多支持100个。

*

String

指定接收消息的标签标签ID列表多个接收者用‘|’分隔最多支持100个。

*

String

企业应用的id整型。

企业内部开发可在应用的设置页面查看第三方服务商可通过接口

获取企业授权信息

表示是否是保密消息0表示可对外分享1表示不能分享且内容显示水印默认为0*/private

String

表示是否开启id转译0表示否1表示是默认0。

仅第三方应用需要用到企业自建应用可以忽略。

*/private

String

表示是否开启重复消息检查0表示否1表示是默认0*/private

String

表示是否重复消息检查的时间间隔默认1800s最大不超过4小时*/private

String

/message/send?access_token{accessToken})MapString,

Object

Maps.newHashMap();}MessageTextDto

messageTextDto

MessageTextDto();messageTextDto.setAgentid(safetyConfig.getAgentId());messageTextDto.setTouser(touser);messageTextDto.getText().setContent(content);String

accessToken

qywxForestClient.messageSend(messageTextDto,

accessToken);return

}其中getAccessToken()调用了前面封装的getAccessToken方法。