Merge pull request #4320 from MrKrisKrisu/dev-ks-swagger
Add missing API endpoint to openapi.yamlmaster
commit
618e00f302
|
@ -131,6 +131,69 @@ paths:
|
||||||
type: boolean
|
type: boolean
|
||||||
type: object
|
type: object
|
||||||
summary: Create alias
|
summary: Create alias
|
||||||
|
/api/v1/add/time_limited_alias:
|
||||||
|
post:
|
||||||
|
responses:
|
||||||
|
"401":
|
||||||
|
$ref: "#/components/responses/Unauthorized"
|
||||||
|
"200":
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
examples:
|
||||||
|
response:
|
||||||
|
value:
|
||||||
|
- log:
|
||||||
|
- mailbox
|
||||||
|
- add
|
||||||
|
- time_limited_alias
|
||||||
|
- address: info@domain.tld
|
||||||
|
domain: domain.tld
|
||||||
|
- null
|
||||||
|
msg:
|
||||||
|
- mailbox_modified
|
||||||
|
- info@domain.tld
|
||||||
|
type: success
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
log:
|
||||||
|
description: contains request object
|
||||||
|
items: {}
|
||||||
|
type: array
|
||||||
|
msg:
|
||||||
|
items: {}
|
||||||
|
type: array
|
||||||
|
type:
|
||||||
|
enum:
|
||||||
|
- success
|
||||||
|
- danger
|
||||||
|
- error
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
|
description: OK
|
||||||
|
headers: {}
|
||||||
|
tags:
|
||||||
|
- Aliases
|
||||||
|
description: >-
|
||||||
|
You may create a time limited alias using this action. It takes a JSON
|
||||||
|
object containing a domain and mailbox informations.
|
||||||
|
Mailcow will generate a random alias.
|
||||||
|
operationId: Create time limited alias
|
||||||
|
requestBody:
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
example:
|
||||||
|
username: info@domain.tld
|
||||||
|
domain: domain.tld
|
||||||
|
properties:
|
||||||
|
username:
|
||||||
|
description: 'the mailbox an alias should be created for'
|
||||||
|
type: string
|
||||||
|
domain:
|
||||||
|
description: "the domain"
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
|
summary: Create time limited alias
|
||||||
/api/v1/add/app-passwd:
|
/api/v1/add/app-passwd:
|
||||||
post:
|
post:
|
||||||
responses:
|
responses:
|
||||||
|
@ -3520,6 +3583,44 @@ paths:
|
||||||
description: You can list mailbox aliases existing in system.
|
description: You can list mailbox aliases existing in system.
|
||||||
operationId: Get aliases
|
operationId: Get aliases
|
||||||
summary: Get aliases
|
summary: Get aliases
|
||||||
|
"/api/v1/get/time_limited_aliases/{mailbox}":
|
||||||
|
get:
|
||||||
|
parameters:
|
||||||
|
- description: mailbox you want to get aliasses from
|
||||||
|
example: domain.tld
|
||||||
|
in: path
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
name: mailbox
|
||||||
|
required: true
|
||||||
|
- description: e.g. api-key-string
|
||||||
|
example: api-key-string
|
||||||
|
in: header
|
||||||
|
name: X-API-Key
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
responses:
|
||||||
|
"401":
|
||||||
|
$ref: "#/components/responses/Unauthorized"
|
||||||
|
"200":
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
examples:
|
||||||
|
response:
|
||||||
|
value:
|
||||||
|
- address: alias@domain.tld
|
||||||
|
goto: destination@domain.tld
|
||||||
|
validity: 1668251246
|
||||||
|
created: "2021-11-12 12:07:26"
|
||||||
|
modified: null
|
||||||
|
description: OK
|
||||||
|
headers: {}
|
||||||
|
tags:
|
||||||
|
- Aliases
|
||||||
|
description: You can list time limited mailbox aliases existing in system.
|
||||||
|
operationId: Get time limited aliases
|
||||||
|
summary: Get time limited aliases
|
||||||
"/api/v1/get/app-passwd/all/{mailbox}":
|
"/api/v1/get/app-passwd/all/{mailbox}":
|
||||||
get:
|
get:
|
||||||
parameters:
|
parameters:
|
||||||
|
|
Loading…
Reference in New Issue