WeKnora/internal/handler/wechat_qrcode.go

98 lines
3.0 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

package handler
import (
"net/http"
"github.com/Tencent/WeKnora/internal/im/wechat"
"github.com/Tencent/WeKnora/internal/logger"
"github.com/gin-gonic/gin"
)
// qrCodeService is a singleton for WeChat QR code operations.
var qrCodeService = wechat.NewQRCodeService()
// WeChatGetQRCode generates a QR code for WeChat login.
// POST /api/v1/wechat/qrcode
//
// WeChatGetQRCode godoc
// @Summary 获取微信扫码登录二维码
// @Description 申请一个用于扫码登录绑定的微信二维码(无请求体)
// @Tags IM 渠道
// @Produce json
// @Success 200 {object} map[string]interface{} "二维码信息(qrcode_url + qrcode 标识)"
// @Failure 500 {object} map[string]interface{} "二维码生成失败"
// @Security Bearer
// @Security ApiKeyAuth
// @Router /wechat/qrcode [post]
func (h *IMHandler) WeChatGetQRCode(c *gin.Context) {
ctx := c.Request.Context()
result, err := qrCodeService.GetLoginQRCode(ctx)
if err != nil {
logger.Errorf(ctx, "[WeChat] Failed to generate QR code: %v", err)
c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to generate QR code: " + err.Error()})
return
}
c.JSON(http.StatusOK, gin.H{
"data": gin.H{
"qrcode_url": result.QRCodeURL,
"qrcode": result.QRCode,
},
})
}
// WeChatPollQRCodeStatus checks the scan status of a WeChat QR code.
// POST /api/v1/wechat/qrcode/status
//
// WeChatPollQRCodeStatus godoc
// @Summary 轮询微信二维码状态
// @Description 查询指定二维码是否已被扫描/确认/过期;confirmed 时返回凭证
// @Tags IM 渠道
// @Accept json
// @Produce json
// @Param request body map[string]interface{} true "{qrcode: string}"
// @Success 200 {object} map[string]interface{} "扫码状态"
// @Failure 400 {object} map[string]interface{} "请求参数错误"
// @Failure 500 {object} map[string]interface{} "服务器错误"
// @Security Bearer
// @Security ApiKeyAuth
// @Router /wechat/qrcode/status [post]
func (h *IMHandler) WeChatPollQRCodeStatus(c *gin.Context) {
ctx := c.Request.Context()
var req struct {
QRCode string `json:"qrcode" binding:"required"`
}
if err := c.ShouldBindJSON(&req); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"error": "qrcode is required"})
return
}
result, err := qrCodeService.PollQRCodeStatus(ctx, req.QRCode)
if err != nil {
logger.Errorf(ctx, "[WeChat] Failed to poll QR code status: %v", err)
c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to check QR code status"})
return
}
resp := gin.H{
"status": result.Status,
}
// Only include credentials when login is confirmed
if result.Status == "confirmed" {
resp["credentials"] = gin.H{
"bot_token": result.BotToken,
"ilink_bot_id": result.ILinkBotID,
"ilink_user_id": result.ILinkUserID,
}
// Include baseurl if the server returned one (may override default)
if result.BaseURL != "" {
resp["baseurl"] = result.BaseURL
}
}
c.JSON(http.StatusOK, gin.H{"data": resp})
}