Загрузка файла

Загрузка файла для использования при отправке сообщений. Загруженные файлы доступны только текущему конечному пользователю.

Запрос

POST /files/upload

Content-Type: multipart/form-data

Параметры формы

Поле

Тип

Обязательное

Описание

file

file

да

Загружаемый файл

user

string

да

Идентификатор пользователя

Пример запроса

POST /v1/files/upload HTTP/1.1 Host: api.evo-ai.ru Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: multipart/form-data Accept: */* Content-Length: 57 { "file": "<бинарный файл>", "user": "test-user" }

Ответ

200 — информация о загруженном файле (ID, имя, размер). Используйте полученный ID в поле files при отправке сообщения.

Пример ответа

{ "id": "72fa9618-8f89-4a37-9b33-7e1178a24a67", "name": "example.png", "size": 1024, "extension": "png", "mime_type": "image/png", "created_by": "6ad1ab0a-73ff-4ac1-b9e4-cdb312f71f13", "created_at": 1577836800 }

Коды ошибок

HTTP

Код

Описание

400

no_file_uploaded

Файл не был передан

400

too_many_files

Принимается только один файл

413

file_too_large

Файл слишком большой

415

unsupported_file_type

Неподдерживаемый тип файла

500

internal_server_error

Внутренняя ошибка сервера

503

s3_connection_failed

Не удалось подключиться к S3