Fix swagger syntax

This commit is contained in:
Kumi 2020-09-03 11:48:31 +02:00
parent 4d1c18c542
commit 92ce2092e7
2 changed files with 11 additions and 14 deletions

File diff suppressed because one or more lines are too long

View file

@ -25,7 +25,7 @@ paths:
parameters:
- in: "body"
name: "data"
description: "JSON defining the email message to be sent"
description: "Object defining the email message to be sent"
required: true
schema:
$ref: "#/definitions/Mail"
@ -38,49 +38,45 @@ paths:
status:
type: "string"
description: "\"Success\" if message was successfully sent, else \"error\""
required: true
error:
type: "string"
description: "Error message, only included if an error has occurred"
required: false
definitions:
Placeholder:
type: "object"
required: ["name"]
properties:
name:
type: "string"
required: true
description: "Name of the placeholder - will be converted to ALL CAPS by the server if it isn't already"
value:
type: "string"
required: false
description: "Value to insert into placeholder"
Attachment:
type: "object"
required: ["url"]
properties:
url:
type: "string"
format: "url"
required: true
description: "URL from where to fetch the file to attach"
filename:
type: "string"
required: false
description: "File name to use for email attachment. If not set, defaults to name from Content-Disposition header of URL if it exists, else the base name of the URL."
Recipient:
type: "object"
required: ["email"]
properties:
email:
type: "string"
format: "email"
required: true
description: "Email address of the recipient"
name:
type: "string"
required: false
description: "Name of the recipient"
Mail:
type: "object"
required: ["recipients", "key"]
properties:
subject:
type: "string"
@ -98,7 +94,6 @@ definitions:
type: "string"
description: "String containing the URL to a file containing the plain text content of the email. Ignored (but still validated) if `text` is provided. If both `texturl` and `html` or `htmlurl` are provided, will create a multi-part MIME message."
recipients:
required: true
type: "array"
description: "Array of `Recipient` objects to be used as \"To:\" addresses for the email"
items: