Defined the PUT /releases/{release_id}/rating/{username} endpoint for the OpenAPI specification document in the library target.
This commit is contained in:
@@ -546,6 +546,43 @@ paths:
|
|||||||
$ref: '#/components/schemas/ReleaseRatingByUser'
|
$ref: '#/components/schemas/ReleaseRatingByUser'
|
||||||
'404':
|
'404':
|
||||||
$ref: '#/components/responses/NotFound'
|
$ref: '#/components/responses/NotFound'
|
||||||
|
put:
|
||||||
|
tags:
|
||||||
|
- Database
|
||||||
|
summary: Update information about a rating of release by a user.
|
||||||
|
description: |
|
||||||
|
Updates a rating of a release for a given user.
|
||||||
|
|
||||||
|
This endpoint requires authentication.
|
||||||
|
operationId: putReleaseRatingByUser
|
||||||
|
parameters:
|
||||||
|
- $ref: '#/components/parameters/ReleaseId'
|
||||||
|
- $ref: '#/components/parameters/Username'
|
||||||
|
- $ref: '#/components/parameters/Rating'
|
||||||
|
security:
|
||||||
|
- Token: []
|
||||||
|
- KeySecret: []
|
||||||
|
- OAuth: []
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: Successfully updated a rating for a specific release by a given user.
|
||||||
|
headers:
|
||||||
|
X-Discogs-RateLimit:
|
||||||
|
$ref: '#/components/headers/RateLimit'
|
||||||
|
X-Discogs-RateLimit-Used:
|
||||||
|
$ref: '#/components/headers/RateLimitUsed'
|
||||||
|
X-Discogs-RateLimit-Remaining:
|
||||||
|
$ref: '#/components/headers/RateLimitRemaining'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ReleaseRatingByUser'
|
||||||
|
'401':
|
||||||
|
$ref: '#/components/responses/Unauthorized'
|
||||||
|
'404':
|
||||||
|
$ref: '#/components/responses/NotFound'
|
||||||
|
'500':
|
||||||
|
$ref: '#/components/responses/InternalError'
|
||||||
/releases/{release_id}/stats:
|
/releases/{release_id}/stats:
|
||||||
get:
|
get:
|
||||||
tags:
|
tags:
|
||||||
@@ -856,12 +893,15 @@ components:
|
|||||||
type: integer
|
type: integer
|
||||||
minimum: 1
|
minimum: 1
|
||||||
maximum: 100
|
maximum: 100
|
||||||
Released:
|
Rating:
|
||||||
description: A filter by release year.
|
description: A number (between 1 and 5) for a rating of a release.
|
||||||
name: released
|
name: rating
|
||||||
in: query
|
in: query
|
||||||
|
required: true
|
||||||
schema:
|
schema:
|
||||||
type: string
|
type: integer
|
||||||
|
minimum: 1
|
||||||
|
maximum: 5
|
||||||
ReleaseId:
|
ReleaseId:
|
||||||
description: An identifier of a release.
|
description: An identifier of a release.
|
||||||
name: release_id
|
name: release_id
|
||||||
@@ -870,6 +910,12 @@ components:
|
|||||||
schema:
|
schema:
|
||||||
type: integer
|
type: integer
|
||||||
example: 249504
|
example: 249504
|
||||||
|
Released:
|
||||||
|
description: A filter by release year.
|
||||||
|
name: released
|
||||||
|
in: query
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
SortOrder:
|
SortOrder:
|
||||||
description: The order to sort the results.
|
description: The order to sort the results.
|
||||||
name: sort_order
|
name: sort_order
|
||||||
|
|||||||
Reference in New Issue
Block a user