Add

[POST] …/v1/file/add

Создаёт новый файл и возвращает его ID.

Метод поддерживает два формата запроса:

• application/json для обратной совместимости, когда содержимое файла передаётся в data как Base64.
• multipart/form-data для потоковой загрузки бинарного файла без Base64 в клиентском запросе.

Входные параметры

Для application/json:

Для multipart/form-data:

Ограничения и проверки

• Метод принимает только один файл за запрос.
• name не длиннее 200 символов.
• extension не длиннее 10 символов.
• width и height передаются только парой и должны быть больше 0.
• duration_ms не может быть отрицательным.
• Клиент не передаёт media_type; поле возвращается в модели File.
• Размер файла ограничивается серверной настройкой file_max_filesize; при превышении возвращается ошибка 1024 (file.size).
• При превышении дисковой квоты аккаунта возвращается ошибка 1222 (disk_space).
• Для multipart/form-data содержимое файла передаётся бинарным потоком без Base64.
• Для JSON-режима учитывайте увеличение размера тела запроса из-за Base64.

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

{
  "name": "photo.jpg",
  "extension": "jpg",
  "data": "/9j/4AAQSkZJRgABAQ...",
  "access_level": "personal",
  "folder_id": 10,
  "width": 1280,
  "height": 720,
  "duration_ms": null
}

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

curl -X POST "https://example.com/v1/file/add" \
  -H "Authorization: Bearer <token>" \
  -F "access_level=personal" \
  -F "folder_id=10" \
  -F "width=1280" \
  -F "height=720" \
  -F "file=@photo.jpg"

Выходные параметры

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

{
  "ok": true,
  "result": {
    "new_id": 12345
  }
}