Add

[POST] …/v1/file/add

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

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

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

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

Для application/json:

Для multipart/form-data:

Примечания:

• Проверки существования/доступности папки выполняются только при версии БД >= 365.
• Для версии БД < 365 работает режим совместимости (без проверок папок).

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

• Метод принимает только один файл за запрос.
• name не длиннее 200 символов.
• extension не длиннее 10 символов.
• Для JSON-режима учитывайте увеличение размера тела запроса из-за Base64.

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

{
  "name": "contract.pdf",
  "extension": "pdf",
  "data": "JVBERi0xLjQKJ...",
  "access_level": "personal",
  "folder_id": 10
}

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

curl -X POST "https://example.com/v1/file/add" \
  -H "Authorization: Bearer <token>" \
  -F "access_level=personal" \
  -F "folder_id=10" \
  -F "file=@contract.pdf"

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

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

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