Файлы и временные ссылки
Артефакты util (сейчас скриншоты; позже HTML, Postman, видео, JSON) хранятся в файловом сервисе. Веб-приложение не отдаёт файлы из строк util напрямую - показываются временные ссылки доступа, выдаваемые по запросу.
Ниже - что видно в UI и ограничения, важные при интеграции и доработке экранов.
Что видно в интерфейсе
На деталях util (напр. Screenshot Multi) у каждого скриншота:
| Понятие | В UI |
|---|---|
| Превью | Картинка в галерее при валидной preview-ссылке |
| Идентификатор файла | Стабильный id артефакта (не меняется при обновлении ссылки) |
| Срок действия | Превью может перестать открываться - файл при этом не «пропал» |
Поле image URL в строке скриншота совпадает с preview, если сервер успешно резолвил ссылку.
Временные ссылки (важно)
Ссылки доступа - presigned URL: работают ограниченное время, затем отдают forbidden/expired.
| Тип ссылки | На деталях util (MVP) | Когда нужна |
|---|---|---|
| Preview (inline) | Резолвится при открытии деталей | Галерея, миниатюры |
| Download (attachment) | Не входит в ответ деталей | Сохранить файл, экспорт - по клику пользователя |
Если превью перестало грузиться:
- Откройте детали снова - сервер обновляет preview-ссылки пакетом, или
- Скачивание / обновление в UI - одна новая ссылка через файловый bridge.
Не кэшируйте preview URL во внешних инструментах дольше срока их жизни.
Категории файлов (продукт)
| Категория | Назначение |
|---|---|
| screenshot | Screenshot Multi и визуальный вывод util |
| html | Планируется |
| postman | Планируется |
| video | Планируется |
| json | Планируется |
Файл привязан к родительской сущности (напр. util-запуск) и категории - доступ и listing ограничены командой.
Загрузка из UI
Продукт поддерживает загрузку скриншотов в файловый сервис из браузера (то же хранилище, что у runner), с привязкой к util-запуску или другой сущности, когда экран даёт upload.
Upload идёт через сессию → короткоживущий токен → отправка в файловый сервис. Перед upload может проверяться квота хранилища команды при включённом биллинге.
Лимиты (backend, видимые эффекты)
| Ограничение | Эффект |
|---|---|
| TTL ссылок | Preview/download истекают; обновите или откройте детали снова |
| Скорость деталей | Много скриншотов → детали дольше готовят превью (MVP: только preview, параллельный resolve) |
| Квота команды | Upload/новые файлы могут быть отклонены при превышении квоты |
| Файловый сервис недоступен | Детали открываются без превью; блок file может быть пуст - метаданные захвата остаются |
| Доступ | Ссылки в контексте вашей команды; другие команды их не откроют |
Внутренние URL сервисов и bridge не являются публичным контрактом - используйте веб-приложение или API с сессией.
См. также
| Версия | 1.2.1 |
| Последнее изменение | 2026-06-28 |