Заказать ZIP-архив выбранных фото
const url = 'https://app.photo-otchet.ru/api/v2/salons/1/photos/archive';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"photo_ids":[1],"format":"webp","max_size":1280}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://app.photo-otchet.ru/api/v2/salons/1/photos/archive \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "photo_ids": [ 1 ], "format": "webp", "max_size": 1280 }'Проверяет состав и заводит заказ. Архив «как есть» (format: webp без max_size) готов сразу — 200 и state: ready. Любой другой формат или размер означает пережатие: ответ 202, state: queued, и дальше спрашивайте GET /photos/archive/{id} раз в две секунды. Повторный заказ того же состава в том же виде отдаёт тот же заказ, а не второй архив. Фото, которые ещё обрабатываются или удалены, в архив не попадают — их число в поле skipped.
Параметры
Заголовок раздела « Parameters »Параметры пути
Заголовок раздела « Path Parameters »Салон
Салон
Тело запросаобязательно
Заголовок раздела « Request Bodyrequired »Что положить в архив и в каком виде.
format: webp без max_size — архив «как есть»: фото ложатся такими, какими лежат у нас, и такой
архив готов сразу, без сборки. Любой другой набор означает пережатие, а значит фоновую задачу.
Сколько фото можно — photos.download.max_photos; число приходит клиенту в «я в салоне»
(limits.archive_max_photos) и в теле отказа 422 archive_too_many.
object
Какие фото положить в архив
Формат файлов внутри архива
Длинные стороны, в которые можно попросить вписать кадр при выдаче. Пусто — «как лежит у нас».
Перечислением, а не настройкой: значения попадают в схему OpenAPI и в кодоген клиента, и ему не приходится зашивать у себя два магических числа (просьба фронтенда 04.11.2026).
Перечисление чисел, а не Literal: размер приходит и в теле (числом), и в строке запроса
(строкой), а Literal[1280, 2048] строку «1280» не принимает — запрос отбивался бы схемой.
Здесь, а не в схемах ручки: формат и размер — две половины одного ответа «в каком виде отдаём картинку», и жить они должны вместе. Отсюда их берут и схема заказа, и ручка «я в салоне», где клиент узнаёт пределы до запроса.
Заказ архива: с ним идти за состоянием и за файлом
Заказ архива глазами клиента.
Одна и та же форма во всех ответах — и на заказ, и на вопрос о состоянии, и в списке своих: клиент рисует её одним кодом, а расхождение «что в ответе» и «что в записи» было бы враньём о состоянии.
Две разные потери: skipped — отброшенные на входе (ещё обрабатываются или удалены),
а total - done при ready — не прочитавшиеся во время сборки. Из-за одного битого кадра
архив на пятьсот фото не теряется.
object
Заказ: с ним идти за состоянием и за файлом
queued, building, ready или failed
Формат файлов внутри архива
Сколько фото попадёт в архив
Сколько уже уложено; при ready — сколько уложилось
Сколько выбранных отброшено на входе
Когда заказан
Когда исчезнет
Пример
{ "state": "queued", "format": "webp"}Заказ принят, архив собирается
Заказ архива глазами клиента.
Одна и та же форма во всех ответах — и на заказ, и на вопрос о состоянии, и в списке своих: клиент рисует её одним кодом, а расхождение «что в ответе» и «что в записи» было бы враньём о состоянии.
Две разные потери: skipped — отброшенные на входе (ещё обрабатываются или удалены),
а total - done при ready — не прочитавшиеся во время сборки. Из-за одного битого кадра
архив на пятьсот фото не теряется.
object
Заказ: с ним идти за состоянием и за файлом
queued, building, ready или failed
Формат файлов внутри архива
Сколько фото попадёт в архив
Сколько уже уложено; при ready — сколько уложилось
Сколько выбранных отброшено на входе
Когда заказан
Когда исчезнет
Пример
{ "state": "queued", "format": "webp"}Нечего архивировать
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "detail": "Среди выбранных нет готовых фото"}Нет действующего входа: нет куки или токена, сессия истекла, токен отозван
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}Срок салона кончился: reason: salon_expired, в теле state и paid_until
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}Прав на это действие нет: не хватает политики или запрещён способ входа
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}Есть невидимое фото
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "detail": "Одно или несколько фото не найдены"}Слишком много фото
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "detail": "В один архив кладётся 500 фото, а выбрано 712"}Салон заблокирован оператором: reason: salon_blocked, причина в blocked_reason
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}Слишком часто
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Примеры
Салон уже собирает
{ "detail": "Салон уже собирает архивы — дождитесь, пока закончится хотя бы один, и повторите"}Этот архив уже скачивают
{ "detail": "Этот архив уже скачивается (2 одновременно) — дождитесь окончания"}