增加分享码查询接口，不写入操作日志表

internal/handler/share_code.go

@@ -165,6 +165,39 @@ func (h *ShareCodeHandler) ListShareCodesByMac(c *gin.Context) {
 	})
 }
 
+// QueryShareCode 查询分享码（预览，不记录导入）
+//
+//	@Summary		查询 EQ 分享码
+//	@Description	根据分享码预览 EQ 数据，不写入导入流水
+//	@Tags			ShareCode
+//	@Produce		json
+//	@Param			shareCode	query		string			true	"5 位分享码"
+//	@Success		200			{object}	map[string]any	"成功返回 eq_data、expire_at"
+//	@Failure		400			{object}	map[string]any	"参数校验失败"
+//	@Failure		500			{object}	map[string]any	"系统错误"
+//	@Router			/audio/shareQuery [get]
+//
+// GET /audio/shareQuery?shareCode=ABC12
+func (h *ShareCodeHandler) QueryShareCode(c *gin.Context) {
+	shareCode := strings.TrimSpace(c.Query("shareCode"))
+	data, ok := h.lookupShareCode(c, shareCode)
+	if !ok {
+		return
+	}
+
+	var eqData any
+	if err := json.Unmarshal([]byte(data.EqData), &eqData); err != nil {
+		eqData = data.EqData
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"code":      200,
+		"msg":       "操作成功",
+		"eq_data":   eqData,
+		"expire_at": data.ExpireAt.Format("2006-01-02 15:04:05"),
+	})
+}
+
 // ImportShareCode 导入分享码
 //
 //	@Summary		导入 EQ 分享码
@@ -191,32 +224,13 @@ func (h *ShareCodeHandler) ImportShareCode(c *gin.Context) {
 		})
 		return
 	}
-	if len(shareCode) != 5 {
-		c.JSON(http.StatusOK, gin.H{
-			"code": 0,
-			"msg":  "分享码无效或已过期",
-		})
+
+	data, ok := h.lookupShareCode(c, shareCode)
+	if !ok {
 		return
 	}
 
 	ctx := c.Request.Context()
-	data, err := h.cache.Get(ctx, shareCode)
-	if err != nil {
-		h.log.Error("get share code failed", zap.String("share_code", shareCode), zap.Error(err))
-		c.JSON(http.StatusOK, gin.H{
-			"code": 500,
-			"msg":  "系统错误",
-		})
-		return
-	}
-	if data == nil {
-		c.JSON(http.StatusOK, gin.H{
-			"code": 0,
-			"msg":  "分享码无效或已过期",
-		})
-		return
-	}
-
 	if err := h.cache.EnqueueImportLog(ctx, mac, shareCode, clientIP, data.EqData, data.ExpireAt); err != nil {
 		h.log.Error("enqueue share import log failed",
 			zap.String("share_code", shareCode),
@@ -240,3 +254,39 @@ func (h *ShareCodeHandler) ImportShareCode(c *gin.Context) {
 		"eq_data": eqData,
 	})
 }
+
+func (h *ShareCodeHandler) lookupShareCode(c *gin.Context, shareCode string) (*cache.ShareCodeData, bool) {
+	if shareCode == "" {
+		c.JSON(http.StatusOK, gin.H{
+			"code": 400,
+			"msg":  "参数校验失败",
+		})
+		return nil, false
+	}
+	if len(shareCode) != 5 {
+		c.JSON(http.StatusOK, gin.H{
+			"code": 0,
+			"msg":  "分享码无效或已过期",
+		})
+		return nil, false
+	}
+
+	ctx := c.Request.Context()
+	data, err := h.cache.Get(ctx, shareCode)
+	if err != nil {
+		h.log.Error("get share code failed", zap.String("share_code", shareCode), zap.Error(err))
+		c.JSON(http.StatusOK, gin.H{
+			"code": 500,
+			"msg":  "系统错误",
+		})
+		return nil, false
+	}
+	if data == nil {
+		c.JSON(http.StatusOK, gin.H{
+			"code": 0,
+			"msg":  "分享码无效或已过期",
+		})
+		return nil, false
+	}
+	return data, true
+}