Сколько фото подойдёт под фильтр
const url = 'https://app.photo-otchet.ru/api/v2/salons/1/photos/search/count';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"filter":{"combinator":"and","not":false,"rules":[{"field":"tags","operator":"hasAny","value":[1]}]},"master_id":1,"binding":"portfolio","removed":"withheld"}'};
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/count \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "filter": { "combinator": "and", "not": false, "rules": [ { "field": "tags", "operator": "hasAny", "value": [ 1 ] } ] }, "master_id": 1, "binding": "portfolio", "removed": "withheld" }'Для подписи на кнопке, пока фильтр собирают.
Считает ровно то, что потом отдаст поиск с теми же параметрами: иначе «найдено 40» и сорок других фото на экране разошлись бы.
Параметры
Заголовок раздела « Parameters »Параметры пути
Заголовок раздела « Path Parameters »Салон
Салон
Тело запросаобязательно
Заголовок раздела « Request Bodyrequired »Сколько фото подойдёт под фильтр: спрашивается, пока фильтр собирают, поэтому без страницы.
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 просят явно.
Сколько работ подойдёт под фильтр
Ответ подсчёта: те же два поля, что в странице.
Лежит рядом с потолком и страницей: это ответ метода count, и держать его в модуле значило бы тянуть
TOTAL_CAP через границу слоя ради одной строки описания.
object
Пример
{ "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"}