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

Расписание дня

GET
/api/v2/salons/{salon_id}/slots
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.

salon_id
required
Salon Id

Салон

integer
>= 1

Салон

master_id
Any of:
integer

Чьи визиты; не задан — свои

date
Any of:
string format: date

Дата, YYYY-MM-DD

all
All

Все мастера салона — по slots:read; вместе с master_id нельзя

boolean

Все мастера салона — по slots:read; вместе с master_id нельзя

Визиты дня с приложенными работами

Media type application/json
Response Listslots
Array<object>
SlotResponse

Визит: время, услуги, клиент (если салон его показывает) и приложенные работы.

object
status
required
SlotStatus

Состояние визита в системе записи: создан, завершён, отменён, удалён.

string
Allowed values: created completed cancelled deleted
datetime_start
required
Datetime Start
string format: date-time
datetime_end
required
Datetime End
string format: date-time
master_id
required
Master Id
integer
disabled
required
Disabled
boolean
name
Any of:
string
title
Any of:
string
id
required
Id
integer
external_id
required
External Id

Id визита в системе записи

integer
created_at
required
Created At
string format: date-time
photos
required
Photos
Array<object>
ResponseDownloadUrl

Карточка фото со ссылками — общая основа всех выдач: списка, поиска, экрана дня, портфолио, колокольчика.

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

urls пусты в двух случаях: фото ещё не обработано и владельцу нечего показывать (жалоба). Второй случай — решение BatchPresigner, потому что зависит от того, кто спрашивает.

object
id
required
Id
integer
created_at
required
Created At
string format: date-time
can_delete
required
Can Delete
boolean
status
required
PhotoStatus

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

string
Allowed values: pending loaded processing ready failed
urls
required
Any of:
PhotoDownloadLink

Ссылки на файл работы: сам кадр и превью.

Ссылки подписанные и временные — живут около суток (точный срок настраивается на сервере). Хранить их у себя нельзя: по истёкшей хранилище откажет. Нужна снова — запросите карточку работы, ссылка придёт новая.

object
full
required
Full

Полный кадр

string format: uri
>= 1 characters <= 2083 characters
thumb
required
Thumb

Превью: им заполняют сетки и списки

string format: uri
>= 1 characters <= 2083 characters
removed_at
Any of:
string format: date-time
removal_reason
Any of:
string
removal_note
Any of:
string
removal_marks
Any of:
RemovalMarks

Разметка вердикта целиком: версия формата и список фигур.

Пустой список принимается и означает «разметки нет»: клиенту проще прислать пустое, чем решать, опускать ли поле, а нам — записать null вместо него (см. is_empty).

object
v
required
V

Версия формата разметки; сейчас 1

integer
Allowed value: 1
shapes
required
Shapes

Фигуры на кадре, не больше 20

Array
<= 20 items
One of: discriminator: type
BoxShape

Фигура по двум точкам: прямоугольник, эллипс, стрелка, отрезок.

У всех четырёх points — это [x1, y1, x2, y2]. У прямоугольника и эллипса порядок неважен (это углы описывающего прямоугольника), у стрелки значащий: от хвоста к острию.

object
color
MarkColor

Цвет из закрытой палитры

string
default: red
Allowed values: red white black yellow cyan
w
MarkWidth

Толщина линии

string
default: mid
Allowed values: thin mid bold
type
required
Type
string
Allowed values: rect ellipse arrow line
points
required
Points

[x1, y1, x2, y2] в долях кадра; у стрелки — от хвоста к острию

Array<number>
>= 4 items <= 4 items
purge_after
Any of:
string format: date-time

Пример

[
{
"status": "created",
"photos": [
{
"status": "pending",
"removal_marks": {
"v": 1,
"shapes": [
{
"color": "red",
"w": "thin",
"type": "rect"
}
]
}
}
]
}
]

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

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

Пример

{
"detail": "Расписание не найдено"
}

Профиля мастера нет

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": "Это относится только к мастеру: у вашей учётной записи нет профиля мастера"
}

Запрос не прошёл проверку схемы

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"
}