mat2-web/matweb/oas/download.yml
2020-07-14 15:28:08 +02:00

40 lines
983 B
YAML

---
tags:
- "File Download"
summary: 'Download a single cleaned file or zip archive containing multiple files'
parameters:
- name: "key"
in: "path"
description: "A key generated for that resource"
required: true
schema:
type: "string"
- name: "secret"
in: "path"
description: "A secret generated for that resource"
required: true
schema:
type: "string"
- name: "filename"
in: "path"
description: "the filename of the cleaned file"
required: true
schema:
type: "string"
responses:
200:
description: "The cleaned file as attachment so a browser downloads the file directly"
content:
"*/*":
schema:
format: binary
400:
description: "Invalid input"
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
404:
description: "The filename, key or secret are wrong or the link is too old and the file has been deleted"