Implemented the GET /marketplace/price_suggestions/{release_id} endpoint for the Open API specification document in the library target.

This commit is contained in:
2025-11-10 00:45:31 +01:00
parent 147930aeaa
commit e5f0430087
+65
View File
@@ -2275,6 +2275,43 @@ paths:
$ref: '#/components/responses/Unauthorized'
'500':
$ref: '#/components/responses/InternalError'
/marketplace/price_suggestions/{release_id}:
get:
tags:
- Marketplace
summary: Get some price suggestions for a given release.
description: |
Retrieves price suggestions for a provided release. If no suggestions are available, an empty object will be returned.
This endpoints requires authentication and also, the user should to have filled out the seller settings. Suggested prices will be denominated in the user's selling currency.
operationId: getPriceSuggestions
parameters:
- $ref: '#/components/parameters/ReleaseId'
security:
- ConsumerKeySecret: []
- UserToken: []
- OAuth: []
responses:
'200':
description: Successfully retrieved price suggestions for a given release.
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:
description: A group of price suggestions for a release.
$ref: '#/components/schemas/ReleasePriceSuggestions'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalError'
components:
headers:
Link:
@@ -4223,6 +4260,34 @@ components:
required:
- instance_id
- resource_url
ReleasePriceSuggestions:
description: A typa the represents a list of price suggestions of a release.
type: object
properties:
"Mint (M)":
description: A suggested price for a release in mint condition, if any.
$ref: '#/components/schemas/Price'
"Near Mint (NM or M-)":
description: A suggested price for a release in near mint condition, if any.
$ref: '#/components/schemas/Price'
"Very Good Plus (VG+)":
description: A suggested price for a release in very good + condition, if any.
$ref: '#/components/schemas/Price'
"Very Good (VG)":
description: A suggested price for a release in very good condition, if any.
$ref: '#/components/schemas/Price'
"Good Plus (G+)":
description: A suggested price for a release in good + condition, if any.
$ref: '#/components/schemas/Price'
"Good (G)":
description: A suggested price for a release in good condition, if any.
$ref: '#/components/schemas/Price'
"Fair (F)":
description: A suggested price for a release in fair condition, if any.
$ref: '#/components/schemas/Price'
"Poor (P)":
description: A suggested price for a release in poor condition, if any.
$ref: '#/components/schemas/Price'
ReleaseFormat:
description: A type that represents a format of a release.
type: object