controllers

Documentation

Index

• func DeleteUser(c *gin.Context)
• func Login(c *gin.Context)
• func PostUser(c *gin.Context)
• func PublicRoute(c *gin.Context)
• func UpdateUser(c *gin.Context)
• func ValidateToken(c *gin.Context)

Functions

func DeleteUser

func DeleteUser(c *gin.Context)

DeleteUser godoc @SecurityDefinitions jwt @SecurityScheme jwt @in header @name Authorization @Summary Deleta um usuário @Description Deleta um usuário pelo ID @ID delete-user @Accept json @Produce json @Tags User @Param id path int true "ID do usuário a ser deletado" @Success 204 {string} string "Usuário deletado com sucesso" @Failure 404 {string} models.ErrorResponse "Usuário não encontrado" @Failure 500 {string} models.ErrorResponse "Erro interno do servidor" @Router /api/delete-user/{id} [delete]

func Login

func Login(c *gin.Context)

Login godoc @Summary Faz o login do usuário e retorna um token JWT @Description Recebe as credenciais do usuário (user name e senha) e retorna um token JWT se as credenciais forem válidas. @ID login @Accept json @Produce json @Tags Auth @Param input body models.Login true "Credenciais de login do usuário" @Success 200 {object} models.AuthResponse "Token JWT gerado" @Failure 400 {object} models.ErrorResponse "Erro de requisição inválida" @Failure 401 {object} models.ErrorResponse "Credenciais inválidas" @Router /api/login [post]

func PostUser

func PostUser(c *gin.Context)

PostUser godoc @Summary Cria um novo usuário @Description Cria um novo usuário com base nos dados fornecidos @ID create-user @Accept json @Produce json @Tags User @Param input body models.User true "Credenciais de login do usuário" @Success 201 {object} models.User "Usuário criado com sucesso" @Failure 400 {string} models.ErrorResponse "Erro de requisição inválida" @Failure 404 {string} models.ErrorResponse "Recurso não encontrado" @Router /api/create-user [post]

func PublicRoute

func PublicRoute(c *gin.Context)

func UpdateUser

func UpdateUser(c *gin.Context)

UpdateUser godoc @SecurityDefinitions jwt @SecurityScheme jwt @in header @name Authorization @Summary Atualiza um usuário @Description Atualiza um usuário pelo ID @ID update-user @Accept json @Produce json @Tags User @Param id path int true "ID do usuário a ser atualizado" @Param input body models.User true "Dados do usuário a serem atualizados" @Success 200 {object} models.User "Usuário atualizado com sucesso" @Failure 400 {string} models.ErrorResponse "Erro de requisição inválida" @Failure 404 {string} models.ErrorResponse "Usuário não encontrado" @Failure 422 {string} models.ErrorResponse "Entidade não processável" @Router /api/update-user/{id} [put]

func ValidateToken

func ValidateToken(c *gin.Context)

ValidateToken valida o token de usuário. @SecurityDefinitions jwt @SecurityScheme jwt @in header @name Authorization @Summary Valida o token de usuário @Description Esse endpoint é responsável por validar o token que foi passado nas requisições das API´s @ID validate-token @Accept json @Produce json @Tags Auth @Param input body models.TokenValidRequest true "Token a ser validado" @Success 200 {object} models.TokenValidResponse "Token validado com sucesso" @Failure 400 {string} models.ErrorResponse "Erro de requisição inválida" @Failure 404 {string} models.ErrorResponse "token inválido" @Router /api/validate-token [post]