mat2-web/matweb/oas/bulk.yml

52 lines
1.3 KiB
YAML
Raw Normal View History

2020-07-13 08:34:18 +02:00
---
tags:
- "File Bulk Download"
summary: 'Group multiple files to download as one zip archive'
2020-07-13 08:37:22 +02:00
description: "This endpoint allows you to bulk download several files
which you uploaded beforehand. Note that the `download_list`
MUST contain more than two files. The max length is configurable
(default is 10)."
2020-07-13 08:34:18 +02:00
consumes:
- "application/json"
produces:
- "application/json"
parameters:
- in: "body"
name: "body"
description: "The files that will be combined for one single download"
required: true
schema:
$ref: '#/definitions/BulkBody'
responses:
201:
description: "A new resource to download all files as one archive"
schema:
$ref: '#/definitions/UploadResponse'
400:
description: "Invalid input"
schema:
$ref: '#/definitions/ErrorResponse'
500:
description: "Unable to clean the file"
schema:
$ref: '#/definitions/ErrorResponse'
definitions:
BulkBody:
type: "object"
properties:
download_list:
type: "array"
description: "An object containing the files you want to create a bulk download for"
items:
$ref: '#/definitions/BulkFile'
BulkFile:
type: "object"
properties:
file_name:
type: "string"
key:
type: "string"
secret:
type: "string"