Теги мастеров: весь справочник
const url = 'https://app.photo-otchet.ru/api/v2/salons/1/tags?include_archived=false&with_usage=false';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/tags?include_archived=false&with_usage=false' \ --header 'Authorization: Bearer <token>'Справочник по порядку показа: он маленький и нужен весь — и разметке, и конструктору фильтра.
Мастеру он приходит суженным: общие теги плюс теги его направлений. Прятать лишнее самому клиенту
не нужно и нельзя — именно это и была та лишняя точка для ошибки, из-за которой затевались направления.
Кто разбирает чужие работы (works:read) и кто ведёт справочник (tags:manage), видят всё.
Архивных по умолчанию нет: ими нельзя размечать, и теги архивного направления скрыты тем же правилом. Тот, что уже стоит на работе, приходит в её тегах — интерфейс покажет его с пометкой и даст снять. Параметр нужен экранам, которые ведут сам справочник.
Параметры
Заголовок раздела « Parameters »Параметры пути
Заголовок раздела « Path Parameters »Салон
Салон
Параметры запроса
Заголовок раздела « Query Parameters »Включить архивные теги: ими нельзя размечать, но они встречаются на старых работах
Включить архивные теги: ими нельзя размечать, но они встречаются на старых работах
Добавить к каждому тегу число размеченных им фото (photos). Считаются все связи, включая фото изъятые и лежащие в корзине: связь существует, и удаление тега стёрло бы разметку у фото, которое может вернуться в обращение. Поэтому число здесь бывает больше, чем видно в ленте, — и ровно это число решает, можно ли тег удалить. Стоит одного соединения с разметкой, по умолчанию не считается
Добавить к каждому тегу число размеченных им фото (photos). Считаются все связи, включая фото изъятые и лежащие в корзине: связь существует, и удаление тега стёрло бы разметку у фото, которое может вернуться в обращение. Поэтому число здесь бывает больше, чем видно в ленте, — и ровно это число решает, можно ли тег удалить. Стоит одного соединения с разметкой, по умолчанию не считается
Справочник тегов мастеров
Тег справочника.
object
Группа тега внутри самого тега: столько, сколько нужно, чтобы его показать и понять, можно ли назначить.
Порядка и числа тегов здесь нет — за ними идут в справочник групп. archived_at есть: тег архивной
группы назначать нельзя, и правило читается на клиенте одинаково для обоих случаев — архив у тега
или у его группы.
Пример сгенерирован
[ { "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" } }]Нет действующего входа: нет куки или токена, сессия истекла, токен отозван
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по 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"}