package cn.lihu.jh.module.system.api.social;
|
|
import cn.lihu.jh.framework.common.exception.ServiceException;
|
import cn.lihu.jh.module.system.api.social.dto.SocialUserBindReqDTO;
|
import cn.lihu.jh.module.system.api.social.dto.SocialUserRespDTO;
|
import cn.lihu.jh.module.system.api.social.dto.SocialUserUnbindReqDTO;
|
|
import javax.validation.Valid;
|
|
/**
|
* 社交用户的 API 接口
|
*
|
* @author 芋道源码
|
*/
|
public interface SocialUserApi {
|
|
/**
|
* 绑定社交用户
|
*
|
* @param reqDTO 绑定信息
|
* @return 社交用户 openid
|
*/
|
String bindSocialUser(@Valid SocialUserBindReqDTO reqDTO);
|
|
/**
|
* 取消绑定社交用户
|
*
|
* @param reqDTO 解绑
|
*/
|
void unbindSocialUser(@Valid SocialUserUnbindReqDTO reqDTO);
|
|
/**
|
* 获得社交用户，基于 userId
|
*
|
* @param userType 用户类型
|
* @param userId 用户编号
|
* @param socialType 社交平台的类型
|
* @return 社交用户
|
*/
|
SocialUserRespDTO getSocialUserByUserId(Integer userType, Long userId, Integer socialType);
|
|
/**
|
* 获得社交用户
|
*
|
* 在认证信息不正确的情况下，也会抛出 {@link ServiceException} 业务异常
|
*
|
* @param userType 用户类型
|
* @param socialType 社交平台的类型
|
* @param code 授权码
|
* @param state state
|
* @return 社交用户
|
*/
|
SocialUserRespDTO getSocialUserByCode(Integer userType, Integer socialType, String code, String state);
|
|
}
|
