Фото: то, на что есть право
const url = 'https://app.photo-otchet.ru/api/v2/salons/1/photos?master_id=42&slot_id=7719&binding=slot&removed=withheld&limit=50&offset=0';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?master_id=42&slot_id=7719&binding=slot&removed=withheld&limit=50&offset=0' \ --header 'Authorization: Bearer <token>'Без параметров отдаёт то, на что есть право: мастеру без works:read — свои, читателю работ — все.
Клиенту не нужно знать, кем он вошёл: лента работ и «мои работы» — это одна ручка с разными параметрами.
При binding=portfolio порядок по дате добавления в портфолио, иначе по дате загрузки.
removed и есть вкладки модерации и корзины — отдельных ручек для них нет. Без параметра приходит
то, что в обращении, плюс своё изъятое на модерацию: владелец видит его на месте, с причиной и сроком.
removed=none просит строго то, что в обращении, — своё изъятое тоже не придёт. Это нужно общей ленте
работ там, где владелец кадра и тот, кто его разбирает, — один человек: без параметра лента
показывает ему то, что он сам же снял с публикации, и снимок оказывается разом среди добавленных
и среди изъятых (06.11.2026). Политики none не требует: он сужает выдачу, а не открывает её.
Параметры
Заголовок раздела « Parameters »Параметры пути
Заголовок раздела « Path Parameters »Салон
Салон
Параметры запроса
Заголовок раздела « Query Parameters »Что из снятого просит список: вкладку изъятого — или наоборот, ничего из снятого.
Не то же, что RemovalKind: вид — свойство строки, а это вопрос запроса, и значений у него на одно
больше. none появился потому, что «без параметра» и «только в обращении» — разные вещи: без параметра
приходит и своё изъятое на модерацию, иначе владелец не нашёл бы снятый кадр там, где он лежит.
Пока владелец кадра и тот, кто его разбирает, — разные люди, одно поведение обслуживало оба экрана;
у салона, где это один человек, общая лента работ стала показывать ему то, что он сам же снял
с публикации (запрос фронтенда 06.11.2026).
Умолчание не меняется: none просят явно.
Изъятое: withheld — вкладка модерации, trashed — корзина, none — только то, что в обращении. Не задан — в обращении плюс своё изъятое на модерацию
Размер страницы
Размер страницы
Смещение страницы
Смещение страницы
Страница работ с ссылками, тегами и мастером
Страница фото. Форма одна у списка и у поиска, чтобы клиент не разбирался, откуда пришёл ответ.
total_capped значит «больше, чем total»: точное число не считали, потому что с фильтром это заставило
бы базу просмотреть все подошедшие строки.
object
Фото в выдаче: карточка со ссылками, чей это мастер и оба вида тегов.
master_id и master_name берутся от владельца (photos.owner_id), а не от привязки к портфолио:
владелец есть у любого фото, а привязки может не быть вовсе.
Оба набора тегов заполняются только по своей политике на чтение: tags — по tags:read,
service_tags — по service_tags:read. Это не про удобство, а часть правила: служебные метки мастеру
не видны нигде, а теги без права на справочник нечем ни отфильтровать, ни выбрать при разметке, так что
показывать их в выдаче незачем. Пустой список значит «права нет», а не «тегов нет».
Поля изъятия (removed_at, removal_reason, removal_note, purge_after) лежат в основе карточки —
ResponseDownloadUrl, — а не здесь: плашка нужна во всех выдачах, включая экран дня и портфолио.
object
Что с файлом работы: ссылка выдана, файл загружен, обрабатывается, готов или не получился.
Ссылки на файл работы: сам кадр и превью.
Ссылки подписанные и временные — живут около суток (точный срок настраивается на сервере). Хранить их у себя нельзя: по истёкшей хранилище откажет. Нужна снова — запросите карточку работы, ссылка придёт новая.
object
Полный кадр
Превью: им заполняют сетки и списки
Разметка вердикта целиком: версия формата и список фигур.
Пустой список принимается и означает «разметки нет»: клиенту проще прислать пустое, чем решать, опускать
ли поле, а нам — записать null вместо него (см. is_empty).
object
Версия формата разметки; сейчас 1
Фигуры на кадре, не больше 20
Фигура по двум точкам: прямоугольник, эллипс, стрелка, отрезок.
У всех четырёх points — это [x1, y1, x2, y2]. У прямоугольника и эллипса порядок неважен (это углы
описывающего прямоугольника), у стрелки значащий: от хвоста к острию.
object
Цвет из закрытой палитры
Толщина линии
[x1, y1, x2, y2] в долях кадра; у стрелки — от хвоста к острию
Надпись: точка — левый верхний угол, плюс сам текст.
object
Цвет из закрытой палитры
Толщина линии
[x, y] — левый верхний угол надписи, в долях кадра
Короткая подпись к месту на кадре
Фото, загруженные мастером вместо этого — приходят только на вкладках изъятия. Метка справочная: вердикт она не снимает, изъятое возвращает только works:release
Теги мастера, по порядку показа
Тег справочника.
object
Группа тега внутри самого тега: столько, сколько нужно, чтобы его показать и понять, можно ли назначить.
Порядка и числа тегов здесь нет — за ними идут в справочник групп. archived_at есть: тег архивной
группы назначать нельзя, и правило читается на клиенте одинаково для обоих случаев — архив у тега
или у его группы.
Служебные метки; мастеру пусто
Тег справочника.
object
Группа тега внутри самого тега: столько, сколько нужно, чтобы его показать и понять, можно ли назначить.
Порядка и числа тегов здесь нет — за ними идут в справочник групп. archived_at есть: тег архивной
группы назначать нельзя, и правило читается на клиенте одинаково для обоих случаев — архив у тега
или у его группы.
Пример
{ "items": [ { "status": "pending", "removal_marks": { "v": 1, "shapes": [ { "color": "red", "w": "thin", "type": "rect" } ] }, "binding": "portfolio" } ], "total_capped": false}Нет действующего входа: нет куки или токена, сессия истекла, токен отозван
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по 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
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}Запрос не прошёл проверку схемы
Запрос не прошёл проверку схемы: единственный отказ, у которого 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"}