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

Теги мастеров: весь справочник

GET
/api/v2/salons/{salon_id}/tags
curl --request GET \
--url 'https://app.photo-otchet.ru/api/v2/salons/1/tags?include_archived=false&with_usage=false' \
--header 'Authorization: Bearer <token>'

Справочник по порядку показа: он маленький и нужен весь — и разметке, и конструктору фильтра.

Мастеру он приходит суженным: общие теги плюс теги его направлений. Прятать лишнее самому клиенту не нужно и нельзя — именно это и была та лишняя точка для ошибки, из-за которой затевались направления. Кто разбирает чужие работы (works:read) и кто ведёт справочник (tags:manage), видят всё.

Архивных по умолчанию нет: ими нельзя размечать, и теги архивного направления скрыты тем же правилом. Тот, что уже стоит на работе, приходит в её тегах — интерфейс покажет его с пометкой и даст снять. Параметр нужен экранам, которые ведут сам справочник.

salon_id
required
Salon Id

Салон

integer
>= 1

Салон

include_archived
Include Archived

Включить архивные теги: ими нельзя размечать, но они встречаются на старых работах

boolean

Включить архивные теги: ими нельзя размечать, но они встречаются на старых работах

with_usage
With Usage

Добавить к каждому тегу число размеченных им фото (photos). Считаются все связи, включая фото изъятые и лежащие в корзине: связь существует, и удаление тега стёрло бы разметку у фото, которое может вернуться в обращение. Поэтому число здесь бывает больше, чем видно в ленте, — и ровно это число решает, можно ли тег удалить. Стоит одного соединения с разметкой, по умолчанию не считается

boolean

Добавить к каждому тегу число размеченных им фото (photos). Считаются все связи, включая фото изъятые и лежащие в корзине: связь существует, и удаление тега стёрло бы разметку у фото, которое может вернуться в обращение. Поэтому число здесь бывает больше, чем видно в ленте, — и ровно это число решает, можно ли тег удалить. Стоит одного соединения с разметкой, по умолчанию не считается

Справочник тегов мастеров

Media type application/json
Response Listtags
Array<object>
TagResponse

Тег справочника.

object
id
required
Id
integer
name
required
Name
string
sort
required
Sort
integer
archived_at
required
Any of:
string format: date-time
photos
Any of:
integer
group
Any of:
TagGroupRef

Группа тега внутри самого тега: столько, сколько нужно, чтобы его показать и понять, можно ли назначить.

Порядка и числа тегов здесь нет — за ними идут в справочник групп. archived_at есть: тег архивной группы назначать нельзя, и правило читается на клиенте одинаково для обоих случаев — архив у тега или у его группы.

object
id
required
Id
integer
name
required
Name
string
archived_at
required
Any of:
string format: date-time

Пример сгенерирован

[
{
"id": 1,
"name": "example",
"sort": 1,
"archived_at": "2026-04-15T12:00:00Z",
"photos": 1,
"group": {
"id": 1,
"name": "example",
"archived_at": "2026-04-15T12:00:00Z"
}
}
]

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

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
ValidationErrorResponse

Запрос не прошёл проверку схемы: единственный отказ, у которого detail — массив.

У доменных отказов detail строкой и reason: invalid (ErrorResponse), так что различать формы можно по reason, а не по типу detail.

object
detail
required
Detail
Array<object>
ValidationItem

Одна ошибка схемы запроса.

object
loc
required
Loc

Где именно: body, имя поля, индекс в списке

Array<string>
type
required
Type

Вид ошибки от pydantic: value_error, int_parsing, missing…

string
msg
required
Msg

Текст ошибки

string
for_user
required
For User

Текст написан для человека и готов к показу (value_error — наш валидатор). false — встроенный текст pydantic на английском: показывайте свою формулировку

boolean
reason
Reason
string
default: validation
Allowed value: validation

Пример

{
"reason": "validation"
}

Салон заблокирован оператором: 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"
}