Fix Join Event service_event

Signed-off-by: Asai Neko <sugar@sne.moe>

api/auth/exchange.go

@@ -16,11 +16,12 @@ import (
 //	@Tags			Authentication
 //	@Accept			json
 //	@Produce		json
-//	@Param			payload	body		service_auth.ExchangeData								true	"Exchange Request Credentials"
-//	@Success		200		{object}	utils.RespStatus{data=service_auth.ExchangeResponse}	"Successful exchange"
-//	@Failure		400		{object}	utils.RespStatus{data=nil}								"Invalid Input"
-//	@Failure		401		{object}	utils.RespStatus{data=nil}								"Unauthorized"
-//	@Failure		500		{object}	utils.RespStatus{data=nil}								"Internal Server Error"
+//	@Param			payload			body		service_auth.ExchangeData								true	"Exchange Request Credentials"
+//	@Param			X-Api-Version	header		string													true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=service_auth.ExchangeResponse}	"Successful exchange"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}								"Invalid Input"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}								"Unauthorized"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}								"Internal Server Error"
 //	@Router			/auth/exchange [post]
 func (self *AuthHandler) Exchange(c *gin.Context) {
 	var exchangeData service_auth.ExchangeData

api/auth/magic.go

@@ -15,11 +15,12 @@ import (
 //	@Tags			Authentication
 //	@Accept			json
 //	@Produce		json
-//	@Param			payload	body		service_auth.MagicData								true	"Magic Link Request Data"
-//	@Success		200		{object}	utils.RespStatus{data=service_auth.MagicResponse}	"Successful request"
-//	@Failure		400		{object}	utils.RespStatus{data=nil}							"Invalid Input"
-//	@Failure		403		{object}	utils.RespStatus{data=nil}							"Turnstile Verification Failed"
-//	@Failure		500		{object}	utils.RespStatus{data=nil}							"Internal Server Error"
+//	@Param			payload			body		service_auth.MagicData								true	"Magic Link Request Data"
+//	@Param			X-Api-Version	header		string												true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=service_auth.MagicResponse}	"Successful request"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}							"Invalid Input"
+//	@Failure		403				{object}	utils.RespStatus{data=nil}							"Turnstile Verification Failed"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}							"Internal Server Error"
 //	@Router			/auth/magic [post]
 func (self *AuthHandler) Magic(c *gin.Context) {
 	var magicData service_auth.MagicData

api/auth/refresh.go

@@ -15,11 +15,12 @@ import (
 //	@Tags			Authentication
 //	@Accept			json
 //	@Produce		json
-//	@Param			payload	body		service_auth.RefreshData							true	"Refresh Token Body"
-//	@Success		200		{object}	utils.RespStatus{data=service_auth.TokenResponse}	"Successful rotation"
-//	@Failure		400		{object}	utils.RespStatus{data=nil}							"Invalid Input"
-//	@Failure		401		{object}	utils.RespStatus{data=nil}							"Invalid Refresh Token"
-//	@Failure		500		{object}	utils.RespStatus{data=nil}							"Internal Server Error"
+//	@Param			payload			body		service_auth.RefreshData							true	"Refresh Token Body"
+//	@Param			X-Api-Version	header		string												true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=service_auth.TokenResponse}	"Successful rotation"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}							"Invalid Input"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}							"Invalid Refresh Token"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}							"Internal Server Error"
 //	@Router			/auth/refresh [post]
 func (self *AuthHandler) Refresh(c *gin.Context) {
 	var refreshData service_auth.RefreshData

api/auth/token.go

@@ -15,11 +15,12 @@ import (
 //	@Tags			Authentication
 //	@Accept			json
 //	@Produce		json
-//	@Param			payload	body		service_auth.TokenData								true	"Token Request Body"
-//	@Success		200		{object}	utils.RespStatus{data=service_auth.TokenResponse}	"Successful token issuance"
-//	@Failure		400		{object}	utils.RespStatus{data=nil}							"Invalid Input"
-//	@Failure		403		{object}	utils.RespStatus{data=nil}							"Invalid or Expired Code"
-//	@Failure		500		{object}	utils.RespStatus{data=nil}							"Internal Server Error"
+//	@Param			payload			body		service_auth.TokenData								true	"Token Request Body"
+//	@Param			X-Api-Version	header		string												true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=service_auth.TokenResponse}	"Successful token issuance"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}							"Invalid Input"
+//	@Failure		403				{object}	utils.RespStatus{data=nil}							"Invalid or Expired Code"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}							"Internal Server Error"
 //	@Router			/auth/token [post]
 func (self *AuthHandler) Token(c *gin.Context) {
 	var tokenData service_auth.TokenData

api/event/checkin.go

@@ -16,11 +16,12 @@ import (
 //	@Tags			Event
 //	@Accept			json
 //	@Produce		json
-//	@Param			event_id	query		string													true	"Event UUID"
-//	@Success		200			{object}	utils.RespStatus{data=service_event.CheckinResponse}	"Successfully generated code"
-//	@Failure		401			{object}	utils.RespStatus{data=nil}								"Missing User ID / Unauthorized"
-//	@Failure		400			{object}	utils.RespStatus{data=nil}								"Invalid Input"
-//	@Failure		500			{object}	utils.RespStatus{data=nil}								"Internal Server Error"
+//	@Param			event_id		query		string													true	"Event UUID"
+//	@Param			X-Api-Version	header		string													true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=service_event.CheckinResponse}	"Successfully generated code"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}								"Missing User ID / Unauthorized"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}								"Invalid Input"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}								"Internal Server Error"
 //	@Security		ApiKeyAuth
 //	@Router			/event/checkin [get]
 func (self *EventHandler) Checkin(c *gin.Context) {

api/event/info.go

@@ -16,12 +16,13 @@ import (
 //	@Tags			Event
 //	@Accept			json
 //	@Produce		json
-//	@Param			event_id	query		string										true	"Event UUID"
-//	@Success		200			{object}	utils.RespStatus{data=data.EventIndexDoc}	"Successful retrieval"
-//	@Failure		400			{object}	utils.RespStatus{data=nil}					"Invalid Input"
-//	@Failure		401			{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
-//	@Failure		404			{object}	utils.RespStatus{data=nil}					"Event Not Found"
-//	@Failure		500			{object}	utils.RespStatus{data=nil}					"Internal Server Error"
+//	@Param			event_id		query		string										true	"Event UUID"
+//	@Param			X-Api-Version	header		string										true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=data.EventIndexDoc}	"Successful retrieval"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}					"Invalid Input"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
+//	@Failure		404				{object}	utils.RespStatus{data=nil}					"Event Not Found"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}					"Internal Server Error"
 //	@Security		ApiKeyAuth
 //	@Router			/event/info [get]
 func (self *EventHandler) Info(c *gin.Context) {

api/event/join.go

@@ -15,12 +15,13 @@ import (
 //	@Tags			Event
 //	@Accept			json
 //	@Produce		json
-//	@Param			request	body		service_event.EventJoinData	true	"Event Join Details (UserId and EventId are required)"
-//	@Success		200		{object}	utils.RespStatus{data=nil}	"Successfully joined the event"
-//	@Failure		400		{object}	utils.RespStatus{data=nil}	"Invalid Input or UUID Parse Failed"
-//	@Failure		401		{object}	utils.RespStatus{data=nil}	"Missing User ID / Unauthorized"
-//	@Failure		403		{object}	utils.RespStatus{data=nil}	"Unauthorized / Missing User ID"
-//	@Failure		500		{object}	utils.RespStatus{data=nil}	"Internal Server Error / Database Error"
+//	@Param			request			body		service_event.EventJoinData	true	"Event Join Details (UserId and EventId are required)"
+//	@Param			X-Api-Version	header		string						true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=nil}	"Successfully joined the event"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}	"Invalid Input or UUID Parse Failed"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}	"Missing User ID / Unauthorized"
+//	@Failure		403				{object}	utils.RespStatus{data=nil}	"Unauthorized / Missing User ID"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}	"Internal Server Error / Database Error"
 //	@Security		ApiKeyAuth
 //	@Router			/event/join [post]
 func (self *EventHandler) Join(c *gin.Context) {

api/event/list.go

@@ -15,12 +15,13 @@ import (
 //	@Tags			Event
 //	@Accept			json
 //	@Produce		json
-//	@Param			limit	query		string										false	"Maximum number of events to return (default 20)"
-//	@Param			offset	query		string										true	"Number of events to skip"
-//	@Success		200		{object}	utils.RespStatus{data=[]data.EventIndexDoc}	"Successful paginated list retrieval"
-//	@Failure		400		{object}	utils.RespStatus{data=nil}					"Invalid Input (Missing offset or malformed parameters)"
-//	@Failure		401		{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
-//	@Failure		500		{object}	utils.RespStatus{data=nil}					"Internal Server Error (Database query failed)"
+//	@Param			limit			query		string										false	"Maximum number of events to return (default 20)"
+//	@Param			offset			query		string										true	"Number of events to skip"
+//	@Param			X-Api-Version	header		string										true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=[]data.EventIndexDoc}	"Successful paginated list retrieval"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}					"Invalid Input (Missing offset or malformed parameters)"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}					"Internal Server Error (Database query failed)"
 //	@Security		ApiKeyAuth
 //	@Router			/event/list [get]
 func (self *EventHandler) List(c *gin.Context) {

api/kyc/query.go

@@ -13,11 +13,12 @@ import (
 // @Tags			KYC
 // @Accept			json
 // @Produce		json
-// @Param			payload	body		service_kyc.KycQueryData							true	"KYC query data (KycId)"
-// @Success		200		{object}	utils.RespStatus{data=service_kyc.KycQueryResponse}	"Query processed (success/pending/failed)"
-// @Failure		400		{object}	utils.RespStatus{data=nil}							"Invalid UUID or input"
-// @Failure		403		{object}	utils.RespStatus{data=nil}							"Unauthorized"
-// @Failure		500		{object}	utils.RespStatus{data=nil}							"Internal Server Error"
+// @Param			payload			body		service_kyc.KycQueryData							true	"KYC query data (KycId)"
+// @Param			X-Api-Version	header		string												true	"latest"
+// @Success		200				{object}	utils.RespStatus{data=service_kyc.KycQueryResponse}	"Query processed (success/pending/failed)"
+// @Failure		400				{object}	utils.RespStatus{data=nil}							"Invalid UUID or input"
+// @Failure		403				{object}	utils.RespStatus{data=nil}							"Unauthorized"
+// @Failure		500				{object}	utils.RespStatus{data=nil}							"Internal Server Error"
 // @Security		ApiKeyAuth
 // @Router			/kyc/query [post]
 func (self *KycHandler) Query(c *gin.Context) {

api/kyc/session.go

@@ -13,11 +13,12 @@ import (
 // @Tags			KYC
 // @Accept			json
 // @Produce		json
-// @Param			payload	body		service_kyc.KycSessionData								true	"KYC session data (Type and Base64 Identity)"
-// @Success		200		{object}	utils.RespStatus{data=service_kyc.KycSessionResponse}	"Session created successfully"
-// @Failure		400		{object}	utils.RespStatus{data=nil}								"Invalid input or decode failed"
-// @Failure		403		{object}	utils.RespStatus{data=nil}								"Missing User ID"
-// @Failure		500		{object}	utils.RespStatus{data=nil}								"Internal Server Error / KYC Service Error"
+// @Param			payload			body		service_kyc.KycSessionData								true	"KYC session data (Type and Base64 Identity)"
+// @Param			X-Api-Version	header		string													true	"latest"
+// @Success		200				{object}	utils.RespStatus{data=service_kyc.KycSessionResponse}	"Session created successfully"
+// @Failure		400				{object}	utils.RespStatus{data=nil}								"Invalid input or decode failed"
+// @Failure		403				{object}	utils.RespStatus{data=nil}								"Missing User ID"
+// @Failure		500				{object}	utils.RespStatus{data=nil}								"Internal Server Error / KYC Service Error"
 // @Security		ApiKeyAuth
 // @Router			/kyc/session [post]
 func (self *KycHandler) Session(c *gin.Context) {

api/user/info.go

@@ -16,10 +16,11 @@ import (
 //	@Tags			User
 //	@Accept			json
 //	@Produce		json
-//	@Success		200	{object}	utils.RespStatus{data=service_user.UserInfoData}	"Successful profile retrieval"
-//	@Failure		401	{object}	utils.RespStatus{data=nil}							"Missing User ID / Unauthorized"
-//	@Failure		404	{object}	utils.RespStatus{data=nil}							"User Not Found"
-//	@Failure		500	{object}	utils.RespStatus{data=nil}							"Internal Server Error (UUID Parse Failed)"
+//	@Param			X-Api-Version	header		string												true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=service_user.UserInfoData}	"Successful profile retrieval"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}							"Missing User ID / Unauthorized"
+//	@Failure		404				{object}	utils.RespStatus{data=nil}							"User Not Found"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}							"Internal Server Error (UUID Parse Failed)"
 //	@Security		ApiKeyAuth
 //	@Router			/user/info [get]
 func (self *UserHandler) Info(c *gin.Context) {

api/user/list.go

@@ -15,12 +15,13 @@ import (
 //	@Tags			User
 //	@Accept			json
 //	@Produce		json
-//	@Param			limit	query		string										false	"Maximum number of users to return (default 0)"
-//	@Param			offset	query		string										true	"Number of users to skip"
-//	@Success		200		{object}	utils.RespStatus{data=[]data.UserIndexDoc}	"Successful paginated list retrieval"
-//	@Failure		401		{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
-//	@Failure		400		{object}	utils.RespStatus{data=nil}					"Invalid Input (Format Error)"
-//	@Failure		500		{object}	utils.RespStatus{data=nil}					"Internal Server Error (Search Engine or Missing Offset)"
+//	@Param			limit			query		string										false	"Maximum number of users to return (default 0)"
+//	@Param			offset			query		string										true	"Number of users to skip"
+//	@Param			X-Api-Version	header		string										true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=[]data.UserIndexDoc}	"Successful paginated list retrieval"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}					"Invalid Input (Format Error)"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}					"Internal Server Error (Search Engine or Missing Offset)"
 //	@Security		ApiKeyAuth
 //	@Router			/user/list [get]
 func (self *UserHandler) List(c *gin.Context) {

api/user/other.go

@@ -16,12 +16,13 @@ import (
 //	@Tags			User
 //	@Accept			json
 //	@Produce		json
-//	@Param			user_id	path		string												true	"Other user id"
-//	@Success		200		{object}	utils.RespStatus{data=service_user.UserInfoData}	"Successful profile retrieval"
-//	@Failure		401		{object}	utils.RespStatus{data=nil}							"Missing User ID / Unauthorized"
-//	@Failure		404		{object}	utils.RespStatus{data=nil}							"User Not Found"
-//	@Failure		403		{object}	utils.RespStatus{data=nil}							"User Not Public"
-//	@Failure		500		{object}	utils.RespStatus{data=nil}							"Internal Server Error (UUID Parse Failed)"
+//	@Param			user_id			path		string												true	"Other user id"
+//	@Param			X-Api-Version	header		string												true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=service_user.UserInfoData}	"Successful profile retrieval"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}							"Missing User ID / Unauthorized"
+//	@Failure		404				{object}	utils.RespStatus{data=nil}							"User Not Found"
+//	@Failure		403				{object}	utils.RespStatus{data=nil}							"User Not Public"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}							"Internal Server Error (UUID Parse Failed)"
 //	@Security		ApiKeyAuth
 //	@Router			/user/info/{user_id} [get]
 func (self *UserHandler) Other(c *gin.Context) {

api/user/update.go

@@ -17,11 +17,12 @@ import (
 //	@Tags			User
 //	@Accept			json
 //	@Produce		json
-//	@Param			payload	body		service_user.UserInfoData	true	"Updated User Profile Data"
-//	@Success		200		{object}	utils.RespStatus{data=nil}	"Successful profile update"
-//	@Failure		400		{object}	utils.RespStatus{data=nil}	"Invalid Input (Validation Failed)"
-//	@Failure		401		{object}	utils.RespStatus{data=nil}	"Missing User ID / Unauthorized"
-//	@Failure		500		{object}	utils.RespStatus{data=nil}	"Internal Server Error (Database Error / UUID Parse Failed)"
+//	@Param			payload			body		service_user.UserInfoData	true	"Updated User Profile Data"
+//	@Param			X-Api-Version	header		string						true	"latest"
+//	@Success		200				{object}	utils.RespStatus{data=nil}	"Successful profile update"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}	"Invalid Input (Validation Failed)"
+//	@Failure		401				{object}	utils.RespStatus{data=nil}	"Missing User ID / Unauthorized"
+//	@Failure		500				{object}	utils.RespStatus{data=nil}	"Internal Server Error (Database Error / UUID Parse Failed)"
 //	@Security		ApiKeyAuth
 //	@Router			/user/update [patch]
 func (self *UserHandler) Update(c *gin.Context) {