程序包 net.sohelp.boot.dev.web.user

类 UserThirdpartQywxController

java.lang.Object
net.sohelp.boot.admin.core.base.BaseController
net.sohelp.boot.dev.web.user.UserThirdpartQywxController
@RestController("dev-user-thirdpart-qywx") @RequestMapping("/dev/user/qywx") public class UserThirdpartQywxController extends BaseController
企业微信第三方控制器 提供与企业微信相关的用户绑定、消息发送及解绑功能。
从以下版本开始:
2024/10/23 17:26
作者:
ShenganWu

  • 构造器详细资料

    • UserThirdpartQywxController

      public UserThirdpartQywxController()

  • 方法详细资料

    • sendQywx

      @PostMapping("/sendQywx") @Permission("ADMIN") @Transactional(rollbackFor=java.lang.Exception.class) public ApiResult<String> sendQywx(@RequestBody Map<String,Object> paramMap) throws Exception
      发送企业微信用户消息 将指定的消息内容通过企业微信发送给目标用户，并记录通知信息到数据库。
      参数:
      paramMap - 请求参数集合，应包含以下字段： - to_user_id：接收人的用户ID（必填） - message：要发送的消息文本（必填）
      返回:
      ApiResult 返回操作结果状态和提示信息
      抛出:
      Exception - 操作过程中可能抛出的异常

    • qywxBinding

      @GetMapping("/binding") @Permission("ADMIN") public ApiResult<String> qywxBinding() throws IOException, TokenAuthenticationException
      跳转至企业微信绑定页面 根据系统配置的企业微信登录参数构造跳转链接并重定向至企业微信授权页。
      返回:
      ApiResult 成功时返回null（执行跳转），失败则返回错误信息
      抛出:
      IOException - IO异常
      TokenAuthenticationException - 认证异常

    • invokeQywxBinding

      @RequestMapping(value="/invoke/binding", method={GET,POST}) @Transactional(rollbackFor=java.lang.Exception.class) @Permission("ADMIN") public Object invokeQywxBinding(@RequestParam Map<String,Object> paramMap) throws Exception
      处理企业微信绑定回调请求 接收来自企业微信的授权码，获取用户信息后完成用户与企业微信账号的绑定关系。
      参数:
      paramMap - 回调携带的参数，包括code等认证信息
      返回:
      Object 绑定成功跳转至用户详情页，失败跳转至错误页
      抛出:
      Exception - 可能发生的业务或IO异常

    • qywxUnbind

      @PostMapping("/unbind") @Permission("ADMIN") @Transactional(rollbackFor=java.lang.Exception.class) public ApiResult<String> qywxUnbind() throws Exception
      解除当前用户的企微绑定关系 删除当前登录用户在系统中的企业微信绑定记录。
      返回:
      ApiResult 返回解绑操作的结果描述
      抛出:
      Exception - 数据库删除过程可能出现的异常