Перейти к содержимому

Сколько фото подойдёт под фильтр

POST
/api/v2/salons/{salon_id}/photos/search/count
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» и сорок других фото на экране разошлись бы.

salon_id
required
Salon Id

Салон

integer
>= 1

Салон

Тело запросаобязательно

Заголовок раздела « Request Bodyrequired »
Media type application/json
PhotoCountRequest

Сколько фото подойдёт под фильтр: спрашивается, пока фильтр собирают, поэтому без страницы.

object
filter
required
FilterGroup

Дерево условий

object
combinator
Combinator
string
default: and
Allowed values: and or
not
Not

Отменяет всю группу

boolean
rules
required
Rules
Array
>= 1 items
One of:
object recursive
master_id
Any of:
integer
binding
Any of:
Binding

Где лежит фото. Значения взаимно исключающие: либо портфолио, либо визит, либо нигде.

string
Allowed values: portfolio slot unbound
removed
Any of:
RemovedFilter

Что из снятого просит список: вкладку изъятого — или наоборот, ничего из снятого.

Не то же, что RemovalKind: вид — свойство строки, а это вопрос запроса, и значений у него на одно больше. none появился потому, что «без параметра» и «только в обращении» — разные вещи: без параметра приходит и своё изъятое на модерацию, иначе владелец не нашёл бы снятый кадр там, где он лежит. Пока владелец кадра и тот, кто его разбирает, — разные люди, одно поведение обслуживало оба экрана; у салона, где это один человек, общая лента работ стала показывать ему то, что он сам же снял с публикации (запрос фронтенда 06.11.2026).

Умолчание не меняется: none просят явно.

string
Allowed values: withheld trashed none

Сколько работ подойдёт под фильтр

Media type application/json
PhotoCountResponse

Ответ подсчёта: те же два поля, что в странице.

Лежит рядом с потолком и страницей: это ответ метода count, и держать его в модуле значило бы тянуть TOTAL_CAP через границу слоя ради одной строки описания.

object
total
required
Total
integer
total_capped
Total Capped
boolean

Пример

{
"total_capped": false
}

Нет действующего входа: нет куки или токена, сессия истекла, токен отозван

Media type application/json
ErrorResponse

Отказ приложения: текст человеку и причина программе.

Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен. Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» — в docs/api/1.0.md, раздел «Формат ошибки».

object
detail
required
Detail

Текст для человека — показывается как есть

string
reason
required
Reason

Причина отказа: по ней ветвится клиент

string
Allowed values: unauthenticated policy forbidden not_found conflict bad_request invalid validation too_many_attempts salon_expired salon_blocked acceptance_required archive_not_ready archive_too_many transcode_unavailable
policy
Any of:
string
limit
Any of:
integer
retry_at
Any of:
string format: date-time
state
Any of:
string
paid_until
Any of:
string format: date-time

Пример

{
"reason": "unauthenticated"
}

Срок салона кончился: reason: salon_expired, в теле state и paid_until

Media type application/json
ErrorResponse

Отказ приложения: текст человеку и причина программе.

Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен. Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» — в docs/api/1.0.md, раздел «Формат ошибки».

object
detail
required
Detail

Текст для человека — показывается как есть

string
reason
required
Reason

Причина отказа: по ней ветвится клиент

string
Allowed values: unauthenticated policy forbidden not_found conflict bad_request invalid validation too_many_attempts salon_expired salon_blocked acceptance_required archive_not_ready archive_too_many transcode_unavailable
policy
Any of:
string
limit
Any of:
integer
retry_at
Any of:
string format: date-time
state
Any of:
string
paid_until
Any of:
string format: date-time

Пример

{
"reason": "unauthenticated"
}

Прав на это действие нет: не хватает политики или запрещён способ входа

Media type application/json
ErrorResponse

Отказ приложения: текст человеку и причина программе.

Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен. Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» — в docs/api/1.0.md, раздел «Формат ошибки».

object
detail
required
Detail

Текст для человека — показывается как есть

string
reason
required
Reason

Причина отказа: по ней ветвится клиент

string
Allowed values: unauthenticated policy forbidden not_found conflict bad_request invalid validation too_many_attempts salon_expired salon_blocked acceptance_required archive_not_ready archive_too_many transcode_unavailable
policy
Any of:
string
limit
Any of:
integer
retry_at
Any of:
string format: date-time
state
Any of:
string
paid_until
Any of:
string format: date-time

Пример

{
"reason": "unauthenticated"
}

Салона нет, он вне объёма сессии или токена, членство выключено — один ответ на все случаи, иначе по разнице читалось бы, в каких салонах состоит учётка

Media type application/json
ErrorResponse

Отказ приложения: текст человеку и причина программе.

Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен. Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» — в docs/api/1.0.md, раздел «Формат ошибки».

object
detail
required
Detail

Текст для человека — показывается как есть

string
reason
required
Reason

Причина отказа: по ней ветвится клиент

string
Allowed values: unauthenticated policy forbidden not_found conflict bad_request invalid validation too_many_attempts salon_expired salon_blocked acceptance_required archive_not_ready archive_too_many transcode_unavailable
policy
Any of:
string
limit
Any of:
integer
retry_at
Any of:
string format: date-time
state
Any of:
string
paid_until
Any of:
string format: date-time

Пример

{
"reason": "unauthenticated"
}

Фильтр не подходит

Media type application/json
ErrorResponse

Отказ приложения: текст человеку и причина программе.

Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен. Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» — в docs/api/1.0.md, раздел «Формат ошибки».

object
detail
required
Detail

Текст для человека — показывается как есть

string
reason
required
Reason

Причина отказа: по ней ветвится клиент

string
Allowed values: unauthenticated policy forbidden not_found conflict bad_request invalid validation too_many_attempts salon_expired salon_blocked acceptance_required archive_not_ready archive_too_many transcode_unavailable
policy
Any of:
string
limit
Any of:
integer
retry_at
Any of:
string format: date-time
state
Any of:
string
paid_until
Any of:
string format: date-time

Примеры

Нет такого тега

{
"detail": "В условии «tags» теги, которых нет в справочнике: [7]"
}

Салон заблокирован оператором: reason: salon_blocked, причина в blocked_reason

Media type application/json
ErrorResponse

Отказ приложения: текст человеку и причина программе.

Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен. Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» — в docs/api/1.0.md, раздел «Формат ошибки».

object
detail
required
Detail

Текст для человека — показывается как есть

string
reason
required
Reason

Причина отказа: по ней ветвится клиент

string
Allowed values: unauthenticated policy forbidden not_found conflict bad_request invalid validation too_many_attempts salon_expired salon_blocked acceptance_required archive_not_ready archive_too_many transcode_unavailable
policy
Any of:
string
limit
Any of:
integer
retry_at
Any of:
string format: date-time
state
Any of:
string
paid_until
Any of:
string format: date-time

Пример

{
"reason": "unauthenticated"
}