新增分享码功能

internal/handler/device.go

@@ -24,6 +24,17 @@ func NewDeviceHandler(redis *redis.Client, log *zap.Logger) *DeviceHandler {
 	}
 }
 
+// ReportDevInfo 上报设备信息
+//
+//	@Summary	上报设备信息
+//	@Tags		Device
+//	@Produce	json
+//	@Param		mac		query		string	true	"设备 MAC 地址"
+//	@Param		model	query		string	true	"设备型号"
+//	@Param		ver		query		string	false	"固件版本号"
+//	@Success	200		{object}	map[string]any	"操作成功"
+//	@Failure	500		{object}	object
+//	@Router		/audio/reportDevInfo [get]
 func (h *DeviceHandler) ReportDevInfo(c *gin.Context) {
 	mac := strings.TrimSpace(c.Query("mac"))
 	model := strings.TrimSpace(c.Query("model"))