Доступ и интерфейс

Медиакеш не публичный: обращения принимаются только из внутренней сети и с выданным ключом проекта. Ниже — то, что нужно знать при настройке рабочего места или сборочного скрипта.

Кому выдаётся доступ

Сотрудники: по заявке руководителя, доступ на чтение во всех зонах, запись — в зонах своих проектов.
Подрядчики: ключ на срок договора, только папка конкретного проекта, запись отдельно согласуется.
Сборочные скрипты: служебный ключ без срока, но с ограничением по адресам и по объёму суточной выгрузки.
Отзыв: ключ гасится в течение часа после заявки; выданные ссылки перестают работать сразу.

Адреса файлов

Адрес собирается из проекта, версии и имени. Зона в адресе не указывается — её выбирает узел, ближайший к тому, кто спрашивает.

GET /p/<проект>/<версия>/<имя-файла>
GET /p/primer/v03/primer-2026-08-15-cut-chernovik-v03.mov

# перечень версий проекта
GET /p/primer/index.json

# поиск по индексу, ответ — список адресов
GET /find?project=primer&type=cut&since=2026-08-01

Ответ на index.json — обычный список объектов с полями name, size, sha256, zone, stored_at и expires_at. Ориентируйтесь на sha256, а не на размер: одинаковый размер у разных сборок встречается чаще, чем кажется.

Заголовки

Заголовок	Смысл
`X-Zone`	зона, из которой пришёл ответ
`X-Layer`	`hot` или `cold` — слой хранения
`X-Version`	версия материала в индексе
`ETag`	контрольная сумма, совпадает с полем `sha256`
`Cache-Control`	для готовых роликов — сутки, для черновиков — `no-store`
`Accept-Ranges`	частичная выдача поддерживается везде, монтажные программы этим пользуются

Если в ответе X-Layer: cold, первые секунды отдача будет медленной: материал поднимается из архивного слоя. Повторный запрос через минуту пойдёт уже быстро.

Загрузка

Загрузка идёт кусками по 64 МБ с докачкой. Обрыв связи не требует начинать заново: приёмник помнит, сколько кусков принял, и ждёт продолжения до шести часов.

POST /upload/init      // отдаёт идентификатор сессии
PUT  /upload/<id>/<n>   // кусок номер n
POST /upload/<id>/done // сверка контрольной суммы

Сверка обязательна. Пока не пришёл done, файл лежит в отстойнике и в поиске не виден.

Ночная выкладка материалов — Ночная выкладка карточек: большие объёмы удобнее заливать вне рабочего дня, узел в это время свободен.

Ошибки

Код	Что случилось	Что делать
401	ключ не принят или отозван	проверьте срок ключа, потом пишите на почту
403	чужой проект	запросить доступ у владельца проекта
404	версии нет либо истёк срок	посмотреть `index.json`, материал мог уехать в архив
409	такая версия уже существует	увеличить номер версии, перезапись запрещена
413	файл больше предельного	сверьтесь с таблицей размеров
423	зона в окне обслуживания	подождать окончания окна либо выбрать другую зону
507	в зоне нет места	дежурная смена уже видит, выберите другую зону

Клиенты

Проводник рабочего места — папка проекта подключается как сетевой диск, настраивается один раз при выдаче ключа.
Монтажная станция — работает напрямую по адресам, частичная выдача позволяет открывать длинные исходники без полной загрузки.
Сборочный скрипт — обычный HTTP-клиент. Держите не больше четырёх параллельных потоков на один ключ, иначе узел начнёт притормаживать вас в пользу интерактивных обращений.