:art:【企业微信】第三方应用接口增加支持是否忽略SuiteAccessToken的post重载方法

This commit is contained in:
Binary Wang 2024-10-31 16:15:21 +08:00
parent 12b83affe4
commit 5a811fff9d
2 changed files with 20 additions and 8 deletions

View File

@ -21,7 +21,7 @@ public interface WxCpTpService {
/**
* <pre>
* 验证推送过来的消息的正确性
* 详情请见: https://work.weixin.qq.com/api/doc#90000/90139/90968/消息体签名校验
* 详情请见: <a href="https://work.weixin.qq.com/api/doc#90000/90139/90968/">消息体签名校验</a>
* </pre>
*
* @param msgSignature 消息签名
@ -48,7 +48,7 @@ public interface WxCpTpService {
* 且在多线程同时刷新时只刷新一次避免超出2000次/日的调用次数上限
* 本service的所有方法都会在suite_access_token过期是调用此方法
* 程序员在非必要情况下尽量不要主动调用此方法
* 详情请见: https://work.weixin.qq.com/api/doc#90001/90143/90600
* 详情请见: <a href="https://work.weixin.qq.com/api/doc#90001/90143/90600">文档</a>
* </pre>
*
* @param forceRefresh 强制刷新
@ -86,7 +86,7 @@ public interface WxCpTpService {
/**
* <pre>
* 保存企业微信定时推送的suite_ticket,每10分钟
* 详情请见https://work.weixin.qq.com/api/doc#90001/90143/90628
* 详情请见<a href="https://work.weixin.qq.com/api/doc#90001/90143/90628">文档</a>
*
* 注意微信不是固定10分钟推送suite_ticket的, 且suite_ticket的有效期为30分钟
* https://work.weixin.qq.com/api/doc/10975#%E8%8E%B7%E5%8F%96%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BA%94%E7%94%A8%E5%87%AD%E8%AF%81
@ -101,7 +101,7 @@ public interface WxCpTpService {
* 获得suite_ticket
* 由于suite_ticket是微信服务器定时推送每10分钟不能主动获取如果碰到过期只能抛异常
*
* 详情请见https://work.weixin.qq.com/api/doc#90001/90143/90628
* 详情请见<a href="https://work.weixin.qq.com/api/doc#90001/90143/90628">文档</a>
* </pre>
*
* @param forceRefresh 强制刷新
@ -116,7 +116,7 @@ public interface WxCpTpService {
/**
* <pre>
* 保存企业微信定时推送的suite_ticket,每10分钟
* 详情请见https://work.weixin.qq.com/api/doc#90001/90143/90628
* 详情请见<a href="https://work.weixin.qq.com/api/doc#90001/90143/90628">文档</a>
*
* 注意微信不是固定10分钟推送suite_ticket的, 且suite_ticket的有效期为30分钟
* https://work.weixin.qq.com/api/doc/10975#%E8%8E%B7%E5%8F%96%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BA%94%E7%94%A8%E5%87%AD%E8%AF%81
@ -286,6 +286,17 @@ public interface WxCpTpService {
*/
String post(String url, String postData) throws WxErrorException;
/**
* 当本Service没有实现某个API的时候可以用这个针对所有微信API中的POST请求.
*
* @param url 接口地址
* @param postData 请求body字符串
* @param withoutSuiteAccessToken 请求是否忽略SuiteAccessToken 默认不忽略-false
* @return the string
* @throws WxErrorException the wx error exception
*/
String post(String url, String postData, boolean withoutSuiteAccessToken) throws WxErrorException;
/**
* <pre>
* Service没有实现某个API的时候可以用这个
@ -395,7 +406,7 @@ public interface WxCpTpService {
/**
* 获取带参授权链接
* <p>
* 文档地址https://developer.work.weixin.qq.com/document/path/95436
* <a href="https://developer.work.weixin.qq.com/document/path/95436">查看文档</a>
*
* @param state state
* @param templateIdList 代开发自建应用模版ID列表数量不能超过9个
@ -548,7 +559,7 @@ public interface WxCpTpService {
/**
* 创建机构级jsApiTicket签名
* 详情参见企业微信第三方应用开发文档https://work.weixin.qq.com/api/doc/90001/90144/90539
* 详情参见<a href="https://work.weixin.qq.com/api/doc/90001/90144/90539">企业微信第三方应用开发文档</a>
*
* @param url 调用JS接口页面的完整URL
* @param authCorpId the auth corp id
@ -559,7 +570,7 @@ public interface WxCpTpService {
/**
* 创建应用级jsapiTicket签名
* 详情参见企业微信第三方应用开发文档https://work.weixin.qq.com/api/doc/90001/90144/90539
* 详情参见<a href="https://work.weixin.qq.com/api/doc/90001/90144/90539">企业微信第三方应用开发文档</a>
*
* @param url 调用JS接口页面的完整URL
* @param authCorpId the auth corp id

View File

@ -337,6 +337,7 @@ public abstract class BaseWxCpTpServiceImpl<H, P> implements WxCpTpService, Requ
* @return the string
* @throws WxErrorException the wx error exception
*/
@Override
public String post(String url, String postData, boolean withoutSuiteAccessToken) throws WxErrorException {
return execute(SimplePostRequestExecutor.create(this), url, postData, withoutSuiteAccessToken);
}