Завантаження

Що це

Файл завжди спершу потрапляє в медіатеку, з id і статусом, і далі на нього посилаються лише за цим id — пост ніколи не несе байтів, лише mediaId. Додати його можна двома способами: завантажити байти напряму — у дашборді або через API — або, через API і MCP, імпортувати з публічного URL.

Пряме завантаження

Киньте файл у Медіа або в редактор під час написання поста.
Дашборд резервує id і одноразовий URL завантаження, а потім робить PUT байтів прямо на нього.
Статус файлу проходить uploading → processing → ready (або failed, з причиною). Відео під час processing отримує мініатюру й тривалість.

Та сама двокрокова форма — рівно те, що роблять POST /media/uploads в API та інструмент MCP dropslate_create_upload — див. Довідник API → Media або MCP → Довідник інструментів.

Сторінка Медіа до першого завантаження: папки, зона перетягування з Завантажити й фільтри.

Медіа одразу після того, як файл кинуто в зону завантаження: картка нового файлу першою в медіатеці, з позначкою Обробка.

Імпорт з URL

У дашборді імпорту з URL немає; він є в API і MCP — POST /media/from-url або інструмент dropslate_upload_from_url з публічним https-посиланням. Сервер завантажує його напряму — приватні й внутрішні адреси відхиляються, переспрямування йдуть до певної межі, і застосовуються ті самі перевірки розміру й формату, що й для прямого завантаження.

Типові помилки

Помилка	Причина	Що робити
Статус застряг на `processing`	Великий файл ще обробляється.	Зачекайте — опитуйте статус, не завантажуйте знову.
Статус `failed`	Формат не приймається для цього виду файлу, або файл пошкоджений.	Перевірте прийнятні формати на сторінці цільової мережі, виправте файл, завантажте знову.
Імпорт з URL відхилено	URL приватний, внутрішній або не `https`.	Використайте публічний `https`-URL або завантажте файл напряму.