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

Чтобы прикрепить файл к строке через API, сначала загрузите его, а потом запишите ответ в поле файла. Загрузить можно сам файл или ссылку на него.

В сценарии Nodul это проще: узел Загрузить файл делает оба шага сразу. См. Узлы в сценарии.

Загрузить файл

Ожидается multipart-часть file с содержимым файла.

curl \
-X POST \
-H "Authorization: Token YOUR_DATABASE_TOKEN" \
-F file=@photo.png \
"https://table.nodul.ru/api/user-files/upload-file/"

Загрузить файл по URL

Сервис сам скачает файл по адресу из тела запроса.

curl \
-X POST \
-H "Authorization: Token YOUR_DATABASE_TOKEN" \
-H "Content-Type: application/json" \
"https://table.nodul.ru/api/user-files/upload-via-url/" \
--data '{
  "url": "https://example.com/photo.png"
}'

Что приходит в ответе

Оба запроса возвращают объект файла. В нём есть:

• url: адрес файла;
• thumbnails: превью tiny и small, у каждого свои url, width и height;
• name: имя файла в хранилище;
• size: размер в байтах;
• mime_type: тип содержимого;
• is_image: изображение это или нет;
• image_width и image_height: размеры, если это изображение;
• uploaded_at: время загрузки.

Этот объект, или хотя бы его name, можно передать в поле файла при создании или обновлении строки. Поле принимает массив таких объектов, список имён через запятую или массив имён.