Загрузка изображений
Маршрут по умолчанию: POST /app/media/upload. Он принимает один из двух вариантов: multipart-файл в поле file или URL в поле link. В обоих случаях требуется токен проекта в поле token.
Получите токен проекта
Маршрут регистрации GET/POST /app/media/project выключен настройкой project_registration = false. Включайте его только если приложение защищает маршрут авторизацией или другой подходящей политикой доступа.
При включённой регистрации отправьте поля формы:
curl -X POST 'https://app.example.test/app/media/project' \
-H 'Accept: application/json' \
-F 'name=My application' \
-F 'description=Profile image uploads' \
-F 'email=owner@example.test'
Ответ содержит сгенерированный token. Считайте его bearer-секретом. Если публичная регистрация не нужна, создайте запись проекта административным кодом приложения; поля и имя коллекции описаны в контракте адаптера.
Загрузите локальный файл
curl -X POST 'https://app.example.test/app/media/upload' \
-H 'Accept: application/json' \
-F 'token=PROJECT_TOKEN' \
-F 'file=@./photo.jpg'
Не задавайте вручную Content-Type для multipart: curl добавляет границу формы. Плагин проверяет статус загруженного файла, его фактический MIME-тип и размер. MIME, присланный браузером, не считается доверенным источником.
Загрузите публичную ссылку
curl -X POST 'https://app.example.test/app/media/upload' \
-H 'Accept: application/json' \
-F 'token=PROJECT_TOKEN' \
-F 'link=https://images.example.test/photo.jpg'
Допустимы HTTP и HTTPS на стандартных портах. URL с userinfo, приватный/зарезервированный IP, непубличный DNS-ответ и redirect отклоняются. Ответ сервера ограничен размером max_file_size и таймаутом.
Ответ
При Accept: application/json Engine обычно оборачивает ответ в объект со status и data. Полезная нагрузка успешной загрузки содержит:
{
"message": "Image uploaded",
"id": "generated-image-id",
"url": "https://cdn.example.test/media/generated-image-id",
"mime": "image/png",
"width": 1200,
"height": 800,
"color": "#aabbcc",
"size": 84231
}
Используйте id для маршрута обработки изображения. URL зависит от image_uri; это только адрес, который вернул плагин, он не настраивает CDN и web server.
Ошибки запроса
Контроллер отклоняет неподдерживаемый метод, отсутствующие данные, неверный токен, невалидный файл, неверные поля проекта и запросы сверх rate limit. Типовые коды — 400, 403, 405, 422 и 429; итоговый HTTP status зависит также от app.http_always_200 приложения.

