Скачать одно фото, при желании в другом формате
const url = 'https://app.photo-otchet.ru/api/v2/salons/1/photos/1024/file?format=webp';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://app.photo-otchet.ru/api/v2/salons/1/photos/1024/file?format=webp' \ --header 'Authorization: Bearer <token>'Отвечает 302 на подписанную ссылку хранилища — переходить навигацией, а не fetch. Без параметров отдаёт файл таким, какой он у нас лежит (WebP). С format=jpeg (и, если нужно, max_size) кадр пережимается: первое нажатие занимает около секунды, дальше файл берётся из кеша и ответ мгновенный. Пережатие — второе сжатие: оригинала у нас нет, загруженный файл переписывается в WebP при обработке.
Параметры
Заголовок раздела « Parameters »Параметры пути
Заголовок раздела « Path Parameters »Работа салона
Работа салона
Салон
Салон
Параметры запроса
Заголовок раздела « Query Parameters »В каком формате отдать
В каком формате отдать
Длинные стороны, в которые можно попросить вписать кадр при выдаче. Пусто — «как лежит у нас».
Перечислением, а не настройкой: значения попадают в схему OpenAPI и в кодоген клиента, и ему не приходится зашивать у себя два магических числа (просьба фронтенда 04.11.2026).
Перечисление чисел, а не Literal: размер приходит и в теле (числом), и в строке запроса
(строкой), а Literal[1280, 2048] строку «1280» не принимает — запрос отбивался бы схемой.
Здесь, а не в схемах ручки: формат и размер — две половины одного ответа «в каком виде отдаём картинку», и жить они должны вместе. Отсюда их берут и схема заказа, и ручка «я в салоне», где клиент узнаёт пределы до запроса.
Длинная сторона в пикселях
Переход на подписанную ссылку файла
Нет действующего входа: нет куки или токена, сессия истекла, токен отозван
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по 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": "Фото не найдено"}Запрос не прошёл проверку схемы
Запрос не прошёл проверку схемы: единственный отказ, у которого detail — массив.
У доменных отказов detail строкой и reason: invalid (ErrorResponse), так что различать формы
можно по reason, а не по типу detail.
object
Одна ошибка схемы запроса.
object
Где именно: body, имя поля, индекс в списке
Вид ошибки от pydantic: value_error, int_parsing, missing…
Текст ошибки
Текст написан для человека и готов к показу (value_error — наш валидатор). false — встроенный текст pydantic на английском: показывайте свою формулировку
Пример
{ "reason": "validation"}Салон заблокирован оператором: reason: salon_blocked, причина в blocked_reason
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по 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": "Не удалось подготовить файл: попробуйте ещё раз или скачайте фото как есть"}