mirror of
https://github.com/advplyr/audiobookshelf.git
synced 2024-12-20 19:06:06 +01:00
baf5f7fbc3
* Fix: extra type in `Author.yaml`
* Fix: formatting
* Initial library schema
* Additional debugging
* Fix: spec relative paths
* Add: ebook file spec
* Fix: response type should be string
* Linting updates
* Add: missing librarySettings
* Temporary fix: Library cron can be null or false
* Author controller updates
* Add: `/api/libraries/{id}` endpoint
* Update library responses
* Add: descriptions
* Fix: queries should be in body
* Fix: `body` should be `requestBody`
* Move: `libraryController` paths, clean up `requestBody`
* Clean up libraryController parameters
* Move: author endpoints to controller
* Add `get` for author images
* Simplify author schema with items
* Remove: unused response type
* Update: formatting
* Update json
* Update requestBody on LibraryController
* LibrarySettings update
* Replace: generic parameter with path specific parameter
* Fix: requestBody descriptions
* Fix: match post operation
* Temporary: nullable Author schemas
* LibraryController items endpoint
* Add: delete library items with issues
* Massive cleanup and violation fixing
* Update bundled spec
* Add: remove library items with issues
* Add: library items endpoint
* Fix: errors
* Fix: base schemas
* Add: series schemas
* Add: library series endpoint
* Fix: oneOf and array issues
* Add: author search region for matching
* Add: series endpoints
* Fix: series issues
* Add library series endpoint and update deprecation
* Fix: series endpoint deprecation
* Fix: `name` in `sortDesc` schema
* Add: workflow for linting spec
* Update OpenAPI readme
73 lines
2.8 KiB
YAML
73 lines
2.8 KiB
YAML
components:
|
|
schemas:
|
|
oldLibraryItemId:
|
|
description: The ID of library items on server version 2.2.23 and before.
|
|
type: string
|
|
nullable: true
|
|
format: 'li_[a-z0-9]{18}'
|
|
example: li_o78uaoeuh78h6aoeif
|
|
libraryItemId:
|
|
type: string
|
|
description: The ID of library items after 2.3.0.
|
|
format: uuid
|
|
example: e4bb1afb-4a4f-4dd6-8be0-e615d233185b
|
|
libraryItemBase:
|
|
type: object
|
|
description: Base library item schema
|
|
properties:
|
|
id:
|
|
$ref: '#/components/schemas/libraryItemId'
|
|
oldLibraryItemId:
|
|
$ref: '#/components/schemas/oldLibraryItemId'
|
|
ino:
|
|
$ref: '../schemas.yaml#/components/schemas/inode'
|
|
libraryId:
|
|
$ref: './Library.yaml#/components/schemas/libraryId'
|
|
folderId:
|
|
$ref: './Folder.yaml#/components/schemas/folderId'
|
|
path:
|
|
description: The path of the library item on the server.
|
|
type: string
|
|
relPath:
|
|
description: The path, relative to the library folder, of the library item.
|
|
type: string
|
|
isFile:
|
|
description: Whether the library item is a single file in the root of the library folder.
|
|
type: boolean
|
|
mtimeMs:
|
|
description: The time (in ms since POSIX epoch) when the library item was last modified on disk.
|
|
type: integer
|
|
ctimeMs:
|
|
description: The time (in ms since POSIX epoch) when the library item status was changed on disk.
|
|
type: integer
|
|
birthtimeMs:
|
|
description: The time (in ms since POSIX epoch) when the library item was created on disk. Will be 0 if unknown.
|
|
type: integer
|
|
addedAt:
|
|
$ref: '../schemas.yaml#/components/schemas/addedAt'
|
|
updatedAt:
|
|
$ref: '../schemas.yaml#/components/schemas/updatedAt'
|
|
isMissing:
|
|
description: Whether the library item was scanned and no longer exists.
|
|
type: boolean
|
|
isInvalid:
|
|
description: Whether the library item was scanned and no longer has media files.
|
|
type: boolean
|
|
mediaType:
|
|
$ref: './mediaTypes/media.yaml#/components/schemas/mediaType'
|
|
libraryItemMinified:
|
|
type: object
|
|
description: A single item on the server, like a book or podcast. Minified media format.
|
|
allOf:
|
|
- $ref: '#/components/schemas/libraryItemBase'
|
|
- type: object
|
|
properties:
|
|
media:
|
|
$ref: './mediaTypes/media.yaml#/components/schemas/mediaMinified'
|
|
libraryItemSequence:
|
|
type: object
|
|
description: A single item on the server, like a book or podcast. Includes series sequence information.
|
|
allOf:
|
|
- $ref: '#/components/schemas/libraryItemBase'
|
|
- $ref: './entities/Series.yaml#/components/schemas/sequence'
|