swagger docs update

This commit is contained in:
nquidox 2026-03-07 15:50:05 +03:00
parent 71d13bb217
commit cfccb19666
3 changed files with 381 additions and 6 deletions

View file

@ -5,6 +5,15 @@ definitions:
name:
type: string
type: object
merch.extraDataDTO:
properties:
links:
items:
$ref: '#/definitions/merch.originLink'
type: array
merch_uuid:
type: string
type: object
merch.merchDTO:
properties:
created_at:
@ -39,9 +48,9 @@ definitions:
type: object
merch.originLink:
properties:
origin_link:
origin:
type: string
origin_name:
origin_link:
type: string
type: object
merch.originsDTO:
@ -51,6 +60,13 @@ definitions:
$ref: '#/definitions/merch.originItem'
type: array
type: object
merch.updateMerchDTO:
properties:
merch_uuid:
type: string
name:
type: string
type: object
responses.BadRequest:
properties:
error:
@ -104,6 +120,44 @@ paths:
summary: Delete merch
tags:
- Merch
put:
consumes:
- application/json
description: Update merch general info (except extra data)
parameters:
- description: merch uuid
in: path
name: uuid
required: true
type: string
- description: payload
in: body
name: payload
required: true
schema:
$ref: '#/definitions/merch.updateMerchDTO'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/merch.merchDTO'
"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'
summary: Update merch
tags:
- Merch
/merch/create:
post:
consumes:
@ -134,6 +188,45 @@ paths:
summary: Create new merch
tags:
- Merch
/merch/extra/{uuid}:
put:
consumes:
- application/json
description: Update ONLY merch extra data
parameters:
- description: merch uuid
in: path
name: uuid
required: true
type: string
- description: payload
in: body
name: payload
required: true
schema:
$ref: '#/definitions/merch.extraDataDTO'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/merch.extraDataDTO'
"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'
summary: Update merch extra data
tags:
- Merch
/merch/list:
get:
description: Get all merch without origins