mirror of
https://github.com/advplyr/audiobookshelf.git
synced 2024-12-20 19:06:06 +01:00
Update: bundled spec
This commit is contained in:
Nicholas Wallace
parent
b8e17de8b4
commit
6d14ed8a72
@ -29,6 +29,10 @@
|
||||
"name": "Series",
|
||||
"description": "Series endpoints"
|
||||
},
|
||||
{
|
||||
"name": "Email",
|
||||
"description": "Email endpoints"
|
||||
},
|
||||
{
|
||||
"name": "Notification",
|
||||
"description": "Notifications endpoints"
|
||||
@ -416,6 +420,132 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/emails": {
|
||||
"get": {
|
||||
"description": "Get email settings",
|
||||
"operationId": "getEmailSettings",
|
||||
"tags": [
|
||||
"Email"
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"$ref": "#/components/responses/email200"
|
||||
}
|
||||
}
|
||||
},
|
||||
"patch": {
|
||||
"summary": "Update email settings",
|
||||
"operationId": "updateEmailSettings",
|
||||
"tags": [
|
||||
"Email"
|
||||
],
|
||||
"requestBody": {
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/EmailSettings"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"$ref": "#/components/responses/email200"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/emails/test": {
|
||||
"post": {
|
||||
"summary": "Send test email",
|
||||
"operationId": "sendTestEmail",
|
||||
"tags": [
|
||||
"Email"
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Successful response"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/emails/ereader-devices": {
|
||||
"post": {
|
||||
"summary": "Update e-reader devices",
|
||||
"operationId": "updateEReaderDevices",
|
||||
"tags": [
|
||||
"Email"
|
||||
],
|
||||
"requestBody": {
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"ereaderDevices": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/EreaderDeviceObject"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"$ref": "#/components/responses/ereader200"
|
||||
},
|
||||
"400": {
|
||||
"description": "Invalid payload"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/emails/send-ebook-to-device": {
|
||||
"post": {
|
||||
"summary": "Send ebook to device",
|
||||
"operationId": "sendEBookToDevice",
|
||||
"tags": [
|
||||
"Email"
|
||||
],
|
||||
"requestBody": {
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"libraryItemId": {
|
||||
"$ref": "#/components/schemas/libraryItemId"
|
||||
},
|
||||
"deviceName": {
|
||||
"$ref": "#/components/schemas/ereaderName"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Successful response"
|
||||
},
|
||||
"400": {
|
||||
"description": "Invalid request"
|
||||
},
|
||||
"403": {
|
||||
"description": "Forbidden"
|
||||
},
|
||||
"404": {
|
||||
"description": "Not found"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/libraries": {
|
||||
"get": {
|
||||
"operationId": "getLibraries",
|
||||
@ -1114,12 +1244,6 @@
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"eventName",
|
||||
"urls",
|
||||
"titleTemplate",
|
||||
"bodyTemplate"
|
||||
],
|
||||
"properties": {
|
||||
"libraryId": {
|
||||
"$ref": "#/components/schemas/libraryIdNullable"
|
||||
@ -1142,7 +1266,13 @@
|
||||
"type": {
|
||||
"$ref": "#/components/schemas/notificationType"
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"eventName",
|
||||
"urls",
|
||||
"titleTemplate",
|
||||
"bodyTemplate"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -1942,6 +2072,110 @@
|
||||
"example": "us",
|
||||
"default": "us"
|
||||
},
|
||||
"ereaderName": {
|
||||
"type": "string",
|
||||
"description": "The name of the e-reader device."
|
||||
},
|
||||
"EreaderDeviceObject": {
|
||||
"type": "object",
|
||||
"description": "An e-reader device configured to receive EPUB through e-mail.",
|
||||
"properties": {
|
||||
"name": {
|
||||
"$ref": "#/components/schemas/ereaderName"
|
||||
},
|
||||
"email": {
|
||||
"type": "string",
|
||||
"description": "The email address associated with the e-reader device."
|
||||
},
|
||||
"availabilityOption": {
|
||||
"type": "string",
|
||||
"description": "The availability option for the device.",
|
||||
"enum": [
|
||||
"adminOrUp",
|
||||
"userOrUp",
|
||||
"guestOrUp",
|
||||
"specificUsers"
|
||||
]
|
||||
},
|
||||
"users": {
|
||||
"type": "array",
|
||||
"description": "List of specific users allowed to access the device.",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"name",
|
||||
"email",
|
||||
"availabilityOption"
|
||||
]
|
||||
},
|
||||
"EmailSettings": {
|
||||
"type": "object",
|
||||
"description": "The email settings configuration for the server. This includes the credentials to send e-books and an array of e-reader devices.",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "The unique identifier for the email settings. Currently this is always `email-settings`",
|
||||
"example": "email-settings"
|
||||
},
|
||||
"host": {
|
||||
"type": "string",
|
||||
"description": "The SMTP host address.",
|
||||
"nullable": true
|
||||
},
|
||||
"port": {
|
||||
"type": "integer",
|
||||
"format": "int32",
|
||||
"description": "The port number for the SMTP server.",
|
||||
"example": 465
|
||||
},
|
||||
"secure": {
|
||||
"type": "boolean",
|
||||
"description": "Indicates if the connection should use SSL/TLS.",
|
||||
"example": true
|
||||
},
|
||||
"rejectUnauthorized": {
|
||||
"type": "boolean",
|
||||
"description": "Indicates if unauthorized SSL/TLS certificates should be rejected.",
|
||||
"example": true
|
||||
},
|
||||
"user": {
|
||||
"type": "string",
|
||||
"description": "The username for SMTP authentication.",
|
||||
"nullable": true
|
||||
},
|
||||
"pass": {
|
||||
"type": "string",
|
||||
"description": "The password for SMTP authentication.",
|
||||
"nullable": true
|
||||
},
|
||||
"testAddress": {
|
||||
"type": "string",
|
||||
"description": "The test email address used for sending test emails.",
|
||||
"nullable": true
|
||||
},
|
||||
"fromAddress": {
|
||||
"type": "string",
|
||||
"description": "The default \"from\" email address for outgoing emails.",
|
||||
"nullable": true
|
||||
},
|
||||
"ereaderDevices": {
|
||||
"type": "array",
|
||||
"description": "List of configured e-reader devices.",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/EreaderDeviceObject"
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"id",
|
||||
"port",
|
||||
"secure",
|
||||
"ereaderDevices"
|
||||
]
|
||||
},
|
||||
"libraryName": {
|
||||
"description": "The name of the library.",
|
||||
"type": "string",
|
||||
@ -2530,6 +2764,34 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"email200": {
|
||||
"description": "Successful response - Email",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/EmailSettings"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"ereader200": {
|
||||
"description": "Successful response - Ereader",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"ereaderDevices": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/EreaderDeviceObject"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"library200": {
|
||||
"description": "Library found.",
|
||||
"content": {
|
||||
|
||||
Loading…
Reference in New Issue
Block a user