Фото по фильтру
const url = 'https://app.photo-otchet.ru/api/v2/salons/1/photos/search';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"filter":{"combinator":"and","not":false,"rules":[{"combinator":"and","not":false,"rules":[]}]},"master_id":1,"binding":"portfolio","removed":"withheld","limit":50,"offset":0}'};
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/search \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "filter": { "combinator": "and", "not": false, "rules": [ { "combinator": "and", "not": false, "rules": [] } ] }, "master_id": 1, "binding": "portfolio", "removed": "withheld", "limit": 50, "offset": 0 }'Страница такая же, как у списка, только с деревом условий И/ИЛИ/НЕ по тегам и дате добавления.
Относительные периоды («эта неделя») считаются в момент запроса и в поясе студии, поэтому один и тот же сохранённый фильтр на следующей неделе покажет другое.
total считается не больше потолка: если подошло больше, приходит total_capped: true, листать дальше
при этом можно.
Параметры
Заголовок раздела « Parameters »Параметры пути
Заголовок раздела « Path Parameters »Салон
Салон
Тело запросаобязательно
Заголовок раздела « Request Bodyrequired »Поиск фото по фильтру. Дерево условий — то же, что хранится в именованных фильтрах.
binding и master_id работают так же, как у GET /photos, и умолчание общее: не задан — всё, на что
есть право. Лента работ передаёт binding=portfolio явно.
object
Дерево условий; «без фильтра» — это GET /photos
object
Отменяет всю группу
Дерево условий
object
Отменяет всю группу
Есть хотя бы один, есть все или нет ни одного из перечисленных тегов.
object
Id тегов своего справочника
Размечена работа тегами этого вида или нет. Виды независимы: «без служебных» ничего не говорит о тегах мастера.
object
Относительный период: считается в момент запроса, поэтому сохранённый фильтр не протухает.
object
За последние N дней, недель или месяцев.
object
Сколько последних единиц времени брать, включая сегодня.
object
В этот день, не раньше него или не позже него. Дни календарные, в поясе студии.
object
В промежутке, оба конца включительно.
object
Отмечена ли этому фото замена: «загружено вместо этого».
Отдельное поле, а не вид тегов: метка живёт в своей таблице (photo_replacements) и ставит её только
владелец. Нужна на вкладках изъятия — «кто уже перезалил, а кто нет».
object
Причина изъятия: любая из перечисленных или ни одна из них.
hasNone захватывает и фото без причины — в корзину кладут без неё, и это не исключение, а обычное
состояние. Коды берутся из набора в коде: незнакомый даёт отказ схемы, а не молча пустую выдачу.
object
Где лежит работа: в портфолио, в визите или нигде.
Такой же срез умеет параметр binding у списка и поиска, и это не дубль: параметр — контекст экрана,
а условие живёт в дереве, участвует в ИЛИ и сохраняется в именованном фильтре (параметры в нём
не хранятся). Пришли оба — складываются через И.
object
Где лежит фото. Значения взаимно исключающие: либо портфолио, либо визит, либо нигде.
Срок исчезновения: «сегодня».
Значит не позже конца сегодняшнего дня, то есть сюда попадает и просроченное: задача-терминал ходит раз в час, и фото с истёкшим сроком живёт до следующего прохода. Иначе оно не нашлось бы ни одним фильтром — ни в «сегодня», ни в «ближайшие N дней».
object
Исчезнет в ближайшие N дней — тоже «не позже», с просроченным внутри.
Единиц, кроме дней, нет намеренно: весь срок жизни изъятого фото это 44 дня (14 на модерации плюс 30 в корзине), и недели с месяцами здесь только запутали бы.
object
Сколько ближайших дней брать, включая сегодня.
object
Дней вперёд, включая сегодня
Что из снятого просит список: вкладку изъятого — или наоборот, ничего из снятого.
Не то же, что RemovalKind: вид — свойство строки, а это вопрос запроса, и значений у него на одно
больше. none появился потому, что «без параметра» и «только в обращении» — разные вещи: без параметра
приходит и своё изъятое на модерацию, иначе владелец не нашёл бы снятый кадр там, где он лежит.
Пока владелец кадра и тот, кто его разбирает, — разные люди, одно поведение обслуживало оба экрана;
у салона, где это один человек, общая лента работ стала показывать ему то, что он сам же снял
с публикации (запрос фронтенда 06.11.2026).
Умолчание не меняется: 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"}Фильтр не подходит
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Примеры
Нет такого тега
{ "detail": "В условии «tags» теги, которых нет в справочнике: [7]"}Слишком глубокий
{ "detail": "Value error, вложенность групп 4, разрешено 3"}Салон заблокирован оператором: reason: salon_blocked, причина в blocked_reason
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "reason": "unauthenticated"}