Implemented the GET /releases/{release-id} endpoint for the Open API specification documentation in the library target.

This commit is contained in:
2025-10-09 16:48:53 +02:00
parent 21b54ddbc7
commit b8f5c4bad3
+53 -1
View File
@@ -388,7 +388,7 @@ paths:
get:
tags:
- Database
summary: Get master release versions
summary: Get information about the versions of a master release.
description: |
Retrieves a list of all releases that are versions of the specified master release.
@@ -423,6 +423,25 @@ paths:
$ref: '#/components/schemas/ReleaseVersion'
'404':
$ref: '#/components/responses/NotFound'
/releases/{release_id}:
get:
tags:
- Database
summary: Get information about a release
description: Retrieves details for a specific release.
operationId: getRelease
parameters:
- $ref: '#/components/parameters/ReleaseId'
- $ref: '#/components/parameters/Currency'
responses:
'200':
description: Successfully retrieved release details.
content:
application/json:
schema:
$ref: '#/components/schemas/Release'
'404':
$ref: '#/components/responses/NotFound'
components:
schemas:
Artist:
@@ -620,6 +639,22 @@ components:
- status
- submitter
- want
Currency:
description: A list of currency codes defined in the marketplace.
type: string
enum:
- USD
- GBP
- EUR
- CAD
- AUD
- JPY
- CHF
- MXN
- BRL
- NZD
- SEK
- ZAR
Identifier:
description: A type that represents an identifier.
type: object
@@ -1231,6 +1266,15 @@ components:
in: query
schema:
type: string
Currency:
description: |
A currency code in the marketplace.
Defaults to the authenticated users currency.
name: curr_abbr
in: query
schema:
$ref: '#/components/schemas/Currency'
Format:
description: A filter by format.
name: format
@@ -1295,6 +1339,14 @@ components:
in: query
schema:
type: string
ReleaseId:
description: An identifier of a release.
name: release_id
in: path
required: true
schema:
type: integer
example: 249504
SortOrder:
description: The order to sort the results.
name: sort_order