Расписание дня
const url = 'https://app.photo-otchet.ru/api/v2/salons/1/slots?master_id=42&date=2026-10-17&all=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/slots?master_id=42&date=2026-10-17&all=false' \ --header 'Authorization: Bearer <token>'Визиты за день вместе с фото: экран дня собирается одним запросом, а не одиннадцатью.
Без даты берётся сегодняшний день в поясе салона. С all=true — день всего салона: визиты всех мастеров
(группировать по master_id), те же правила фото и имени клиента; без slots:read — 403.
Параметры
Заголовок раздела « Parameters »Параметры пути
Заголовок раздела « Path Parameters »Салон
Салон
Параметры запроса
Заголовок раздела « Query Parameters »Визиты дня с приложенными работами
Визит: время, услуги, клиент (если салон его показывает) и приложенные работы.
object
Состояние визита в системе записи: создан, завершён, отменён, удалён.
Id визита в системе записи
Карточка фото со ссылками — общая основа всех выдач: списка, поиска, экрана дня, портфолио, колокольчика.
Поля изъятия лежат здесь, а не в надстройках, и это исправление: прежде их дописывала каждая выдача сама, и в экране дня их не оказалось — своё изъятое фото приезжало в визит неотличимым от обычного, и пометить его клиенту было нечем. Место у плашки одно, значит и поля одни.
urls пусты в двух случаях: фото ещё не обработано и владельцу нечего показывать (жалоба). Второй
случай — решение BatchPresigner, потому что зависит от того, кто спрашивает.
object
Что с файлом работы: ссылка выдана, файл загружен, обрабатывается, готов или не получился.
Ссылки на файл работы: сам кадр и превью.
Ссылки подписанные и временные — живут около суток (точный срок настраивается на сервере). Хранить их у себя нельзя: по истёкшей хранилище откажет. Нужна снова — запросите карточку работы, ссылка придёт новая.
object
Полный кадр
Превью: им заполняют сетки и списки
Разметка вердикта целиком: версия формата и список фигур.
Пустой список принимается и означает «разметки нет»: клиенту проще прислать пустое, чем решать, опускать
ли поле, а нам — записать null вместо него (см. is_empty).
object
Версия формата разметки; сейчас 1
Фигуры на кадре, не больше 20
Фигура по двум точкам: прямоугольник, эллипс, стрелка, отрезок.
У всех четырёх points — это [x1, y1, x2, y2]. У прямоугольника и эллипса порядок неважен (это углы
описывающего прямоугольника), у стрелки значащий: от хвоста к острию.
object
Цвет из закрытой палитры
Толщина линии
[x1, y1, x2, y2] в долях кадра; у стрелки — от хвоста к острию
Надпись: точка — левый верхний угол, плюс сам текст.
object
Цвет из закрытой палитры
Толщина линии
[x, y] — левый верхний угол надписи, в долях кадра
Короткая подпись к месту на кадре
Пример
[ { "status": "created", "photos": [ { "status": "pending", "removal_marks": { "v": 1, "shapes": [ { "color": "red", "w": "thin", "type": "rect" } ] } } ] }]Нет действующего входа: нет куки или токена, сессия истекла, токен отозван
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по 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
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "detail": "Расписание не найдено"}Профиля мастера нет
Отказ приложения: текст человеку и причина программе.
Ветвиться нужно по reason — текст detail переписывают, и ломаться об это клиент не должен.
Поля причины приходят рядом и зависят от неё; перечень причин с таблицей «когда и где» —
в docs/api/1.0.md, раздел «Формат ошибки».
object
Текст для человека — показывается как есть
Причина отказа: по ней ветвится клиент
Пример
{ "detail": "Это относится только к мастеру: у вашей учётной записи нет профиля мастера"}Запрос не прошёл проверку схемы
Запрос не прошёл проверку схемы: единственный отказ, у которого 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"}