merch-tracker-v2/api
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

swagger docs update

Browse source
This commit is contained in:
nquidox 2025-09-14 19:34:06 +03:00
parent c59fbc0864
commit 0c518cab50
4 changed files with 147 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

26
internal/api/user/controller.go
View file

@ -159,10 +159,10 @@ func (co *controller) delete(c *gin.Context) {
// @Description Логин
// @Tags Users - auth
// @Accept json
// @Param body body Login true "логин"
// @Success 200 {object} LoginResponse
// @Failure 400 {object} responses.ErrorResponse400
// @Failure 500 {object} responses.ErrorResponse500
// @Param body body Login true "логин"
// @Success 200 {object} LoginResponse
// @Failure 400 {object} responses.ErrorResponse400
// @Failure 500 {object} responses.ErrorResponse500
// @Router /user/auth/login [post]
func (co *controller) login(c *gin.Context) {
var login Login
@ -197,8 +197,8 @@ func (co *controller) login(c *gin.Context) {
// @Description Логаут. Для логаута надо передать refresh token, он будет инвалидирован.
// @Tags Users - auth
// @Success 200
// @Failure 400 {object} responses.ErrorResponse400
// @Failure 500 {object} responses.ErrorResponse500
// @Failure 400 {object} responses.ErrorResponse400
// @Failure 500 {object} responses.ErrorResponse500
// @Router /user/auth/logout [post]
func (co *controller) logout(c *gin.Context) {
refreshUuid, err := co.utils.GetRefreshUuidFromContext(c)
@ -220,9 +220,9 @@ func (co *controller) logout(c *gin.Context) {
// @Summary Обновление аксесс токена по рефреш токену.
// @Description Принимает рефреш токен в http only куки
// @Tags Users - auth
// @Success 200 {object} LoginResponse
// @Failure 400 {object} responses.ErrorResponse400
// @Failure 500 {object} responses.ErrorResponse500
// @Success 200 {object} LoginResponse
// @Failure 400 {object} responses.ErrorResponse400
// @Failure 500 {object} responses.ErrorResponse500
// @Router /user/auth/refresh [post]
func (co *controller) refresh(c *gin.Context) {
refreshUuid, err := co.utils.GetRefreshUuidFromContext(c)
@ -256,10 +256,10 @@ func (co *controller) refresh(c *gin.Context) {
// @Description Возвращает информацию о текущей сессии пользователя
// @Tags Users
// @Security BearerAuth
// @Success 200 {object} shared.CurrentSession
// @Failure 400 {object} responses.ErrorResponse400
// @Failure 401 {object} responses.ErrorResponse401
// @Failure 500 {object} responses.ErrorResponse500
// @Success 200 {object} shared.CurrentSession
// @Failure 400 {object} responses.ErrorResponse400
// @Failure 401 {object} responses.ErrorResponse401
// @Failure 500 {object} responses.ErrorResponse500
// @Router /user/auth/current-session [get]
func (co *controller) getCurrentSession(c *gin.Context) {
refreshUuid, err := co.utils.GetRefreshUuidFromContext(c)