Implemented the GET /users/{username}/collection/value endpoint for the Open API specification document in the library target.

This commit is contained in:
2025-10-16 15:48:22 +02:00
parent 929ccc7e8d
commit e389051221
+53
View File
@@ -1532,6 +1532,42 @@ paths:
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalError'
/users/{username}/collection/value:
get:
tags:
- User Collection
summary: Get the estimated monetary value for a collection of a user.
description: |
Returns the estimated minimum, median, and maximum values for a collection of a user.
This endpoint requires authentication as the collection owner.
operationId: getCollectionValue
parameters:
- $ref: '#/components/parameters/Username'
security:
- ConsumerKeySecret: []
- UserToken: []
- OAuth: []
responses:
'200':
description: Successfully retrieved the estimated monetary value for a collection of a 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/CollectionValue'
'403':
$ref: '#/components/responses/NotAccessable'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalError'
components:
headers:
Link:
@@ -2028,6 +2064,23 @@ components:
properties:
type:
enum: [artist]
CollectionValue:
description: A type that represents the monetary value of a collection.
type: object
properties:
maximum:
description: An estimated maximum monetary value of a collection.
type: string
median:
description: An estimated median monetary value of a collection.
type: string
minimum:
description: An estimated minimumn monetary value of a collection.
type: string
required:
- maximum
- median
- minimum
Community:
description: A type that represents a community of users, in relationship to a release.
type: object