111 lines
No EOL
2.5 KiB
YAML
111 lines
No EOL
2.5 KiB
YAML
get:
|
|
summary: Get user title
|
|
operationId: getUserTitle
|
|
parameters:
|
|
- in: path
|
|
name: user_id
|
|
required: true
|
|
schema:
|
|
type: integer
|
|
format: int64
|
|
- in: path
|
|
name: title_id
|
|
required: true
|
|
schema:
|
|
type: integer
|
|
format: int64
|
|
responses:
|
|
'200':
|
|
description: User titles
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '../schemas/UserTitleMini.yaml'
|
|
'204':
|
|
description: No user title found
|
|
'400':
|
|
description: Request params are not correct
|
|
'404':
|
|
description: User or title not found
|
|
'500':
|
|
description: Unknown server error
|
|
|
|
patch:
|
|
summary: Update a usertitle
|
|
description: User updating title list of watched
|
|
operationId: updateUserTitle
|
|
security:
|
|
- XsrfAuthHeader: []
|
|
parameters:
|
|
- in: path
|
|
name: user_id
|
|
required: true
|
|
schema:
|
|
type: integer
|
|
format: int64
|
|
- in: path
|
|
name: title_id
|
|
required: true
|
|
schema:
|
|
type: integer
|
|
format: int64
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
$ref: '../schemas/enums/UserTitleStatus.yaml'
|
|
rate:
|
|
type: integer
|
|
format: int32
|
|
responses:
|
|
'200':
|
|
description: Title successfully updated
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '../schemas/UserTitleMini.yaml'
|
|
'400':
|
|
description: Invalid request body (missing fields, invalid types, etc.)
|
|
'401':
|
|
description: Unauthorized — missing or invalid auth token
|
|
'403':
|
|
description: Forbidden — user not allowed to update title
|
|
'404':
|
|
description: User or Title not found
|
|
'500':
|
|
description: Internal server error
|
|
|
|
delete:
|
|
summary: Delete a usertitle
|
|
description: User deleting title from list of watched
|
|
operationId: deleteUserTitle
|
|
security:
|
|
- XsrfAuthHeader: []
|
|
parameters:
|
|
- in: path
|
|
name: user_id
|
|
required: true
|
|
schema:
|
|
type: integer
|
|
format: int64
|
|
- in: path
|
|
name: title_id
|
|
required: true
|
|
schema:
|
|
type: integer
|
|
format: int64
|
|
responses:
|
|
'200':
|
|
description: Title successfully deleted
|
|
'401':
|
|
description: Unauthorized — missing or invalid auth token
|
|
'403':
|
|
description: Forbidden — user not allowed to delete title
|
|
'404':
|
|
description: User or Title not found
|
|
'500':
|
|
description: Internal server error |