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

类 UserThirdpartQywxController

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

  • 构造器详细资料

    • UserThirdpartQywxController

      public UserThirdpartQywxController()

  • 方法详细资料

    • sendQywx

      @PostMapping("/sendQywx") @Permission("") @Transactional(rollbackFor=java.lang.Exception.class) public ApiResult<String> sendQywx(@RequestBody Map<String,Object> paramMap) throws Exception
      发送企业微信用户消息 向指定的企业微信用户发送一条文本消息，并记录通知信息到数据库中。
      参数:
      paramMap - 请求参数，必须包含 to_user_id 和 message 字段 - to_user_id：接收用户的ID - message：要发送的消息内容
      返回:
      ApiResult 返回操作结果，成功时返回“发送成功!”，失败则返回错误原因
      抛出:
      Exception - 操作过程中可能抛出的异常

    • qywxBinding

      @GetMapping("/binding") @Permission("") public ApiResult<String> qywxBinding() throws IOException, TokenAuthenticationException
      绑定企业微信账户 引导当前登录用户跳转至企业微信授权页面进行扫码绑定操作。
      返回:
      ApiResult 成功后重定向到企业微信授权页，否则返回错误提示
      抛出:
      IOException - IO异常（如URL编码或重定向）
      TokenAuthenticationException - 认证异常（如无法获取登录ID）

    • invokeQywxBinding

      @RequestMapping(value="/invoke/binding", method={GET,POST}) @Transactional(rollbackFor=java.lang.Exception.class) @Permission("") public Object invokeQywxBinding(@RequestParam Map<String,Object> paramMap) throws Exception
      处理企业微信绑定回调请求 接收来自企业微信的授权码并完成用户与企业微信账号的绑定流程。
      参数:
      paramMap - 请求参数，应包含 code 和 userId 字段 - code：企业微信授权码 - userId：系统中的用户ID
      返回:
      Object 成功后重定向到用户信息页，失败则跳转到错误页面
      抛出:
      Exception - 可能发生的业务或IO异常

    • qywxUnbind

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