swagger docs update

This commit is contained in:
nquidox 2026-03-20 16:13:25 +03:00
parent ea33cdc9f5
commit 229eebcf66
4 changed files with 411 additions and 54 deletions

View file

@ -475,7 +475,7 @@
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/merch.ListResponse"
"$ref": "#/definitions/merch.listResponse"
}
}
},
@ -773,6 +773,56 @@
}
},
"/merch/{uuid}": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"description": "Получить всю информацию про мерч по его uuid",
"produces": [
"application/json"
],
"tags": [
"Merch"
],
"summary": "Получить всю информацию про мерч",
"parameters": [
{
"type": "string",
"description": "merch_uuid",
"name": "uuid",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/merch.singleMerchResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/responses.BadRequest"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"$ref": "#/definitions/responses.Unauthorized"
}
},
"500": {
"description": "Internal Server Error",
"schema": {
"$ref": "#/definitions/responses.InternalServerError"
}
}
}
},
"put": {
"description": "Update merch general info (except extra data)",
"consumes": [
@ -977,6 +1027,74 @@
}
}
}
},
"/user": {
"post": {
"description": "Adds local user record based on user uuid from auth service",
"consumes": [
"application/json"
],
"tags": [
"User"
],
"summary": "Create new user",
"responses": {
"201": {
"description": "Created"
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/responses.BadRequest"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"$ref": "#/definitions/responses.Unauthorized"
}
},
"500": {
"description": "Internal Server Error",
"schema": {
"$ref": "#/definitions/responses.InternalServerError"
}
}
}
},
"delete": {
"description": "Marks user as deleted by user uuid",
"consumes": [
"application/json"
],
"tags": [
"User"
],
"summary": "Delete user",
"responses": {
"204": {
"description": "No Content"
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/responses.BadRequest"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"$ref": "#/definitions/responses.Unauthorized"
}
},
"500": {
"description": "Internal Server Error",
"schema": {
"$ref": "#/definitions/responses.InternalServerError"
}
}
}
}
}
},
"definitions": {
@ -1033,23 +1151,6 @@
}
}
},
"merch.ListResponse": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"merch_uuid": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"merch.OriginWithPrices": {
"type": "object",
"properties": {
@ -1134,6 +1235,23 @@
}
}
},
"merch.listResponse": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"merch_uuid": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"merch.merchDTO": {
"type": "object",
"properties": {
@ -1206,6 +1324,23 @@
}
}
},
"merch.singleMerchResponse": {
"type": "object",
"properties": {
"merch_uuid": {
"type": "string"
},
"name": {
"type": "string"
},
"origins": {
"type": "array",
"items": {
"$ref": "#/definitions/merch.originLink"
}
}
}
},
"merch.updateMerchDTO": {
"type": "object",
"properties": {