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: get:
tags: tags:
- Database - Database
summary: Get master release versions summary: Get information about the versions of a master release.
description: | description: |
Retrieves a list of all releases that are versions of the specified master release. Retrieves a list of all releases that are versions of the specified master release.
@@ -423,6 +423,25 @@ paths:
$ref: '#/components/schemas/ReleaseVersion' $ref: '#/components/schemas/ReleaseVersion'
'404': '404':
$ref: '#/components/responses/NotFound' $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: components:
schemas: schemas:
Artist: Artist:
@@ -620,6 +639,22 @@ components:
- status - status
- submitter - submitter
- want - 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: Identifier:
description: A type that represents an identifier. description: A type that represents an identifier.
type: object type: object
@@ -1231,6 +1266,15 @@ components:
in: query in: query
schema: schema:
type: string 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: Format:
description: A filter by format. description: A filter by format.
name: format name: format
@@ -1295,6 +1339,14 @@ components:
in: query in: query
schema: schema:
type: string type: string
ReleaseId:
description: An identifier of a release.
name: release_id
in: path
required: true
schema:
type: integer
example: 249504
SortOrder: SortOrder:
description: The order to sort the results. description: The order to sort the results.
name: sort_order name: sort_order