package cn.lihu.jh.module.system.api.social;
|
|
import cn.lihu.jh.module.system.api.social.dto.*;
|
import cn.lihu.jh.module.system.enums.social.SocialTypeEnum;
|
|
import javax.validation.Valid;
|
|
import java.util.List;
|
|
/**
|
* 社交应用的 API 接口
|
*
|
* @author 芋道源码
|
*/
|
public interface SocialClientApi {
|
|
/**
|
* 获得社交平台的授权 URL
|
*
|
* @param socialType 社交平台的类型 {@link SocialTypeEnum}
|
* @param userType 用户类型
|
* @param redirectUri 重定向 URL
|
* @return 社交平台的授权 URL
|
*/
|
String getAuthorizeUrl(Integer socialType, Integer userType, String redirectUri);
|
|
/**
|
* 创建微信公众号 JS SDK 初始化所需的签名
|
*
|
* @param userType 用户类型
|
* @param url 访问的 URL 地址
|
* @return 签名
|
*/
|
SocialWxJsapiSignatureRespDTO createWxMpJsapiSignature(Integer userType, String url);
|
|
//======================= 微信小程序独有 =======================
|
|
/**
|
* 获得微信小程序的手机信息
|
*
|
* @param userType 用户类型
|
* @param phoneCode 手机授权码
|
* @return 手机信息
|
*/
|
SocialWxPhoneNumberInfoRespDTO getWxMaPhoneNumberInfo(Integer userType, String phoneCode);
|
|
/**
|
* 获得小程序二维码
|
*
|
* @param reqVO 请求信息
|
* @return 小程序二维码
|
*/
|
byte[] getWxaQrcode(@Valid SocialWxQrcodeReqDTO reqVO);
|
|
/**
|
* 获得微信小程订阅模板
|
*
|
* @return 小程序订阅消息模版
|
*/
|
List<SocialWxaSubscribeTemplateRespDTO> getWxaSubscribeTemplateList(Integer userType);
|
|
/**
|
* 发送微信小程序订阅消息
|
*
|
* @param reqDTO 请求
|
*/
|
void sendWxaSubscribeMessage(SocialWxaSubscribeMessageSendReqDTO reqDTO);
|
|
}
|
