Skip to content

Получить доступные слоты для бронирования услуги

Request

Возвращает список доступных слотов для выбранной услуги на указанную дату.

Слот формируется на основе:

  • рабочего календаря мастера
  • уже занятых интервалов
  • перерывов мастера
  • длительности услуги

Для салонной услуги доступны два взаимоисключающих режима:

  • master_user_id возвращает слоты конкретного мастера с ценой услуги после её скидки в base_price; только для акционного слота дополнительно возвращаются final_price и discount_percent акции;
  • salon_id отдельно рассчитывает слоты каждого назначенного на услугу мастера, объединяет результаты, удаляет только полностью одинаковые пары start_time + end_time и возвращает интервалы с base_price услуги без данных мастеров и акционных скидок.

Пересекающиеся, но не полностью одинаковые интервалы остаются разными слотами.

Ограничения входных данных:

  • service_id должен быть положительным
  • service_id должен ссылаться на существующую услугу
  • date должен быть сегодня или в будущем

Требования:

  • требуется JWT
Security
bearerAuth or jwtCookie
Query
service_idinteger, (int64), >= 1required

Идентификатор услуги.

Example:service_id=20
master_user_idinteger, (int64), >= 1

ID мастера салона. Передаётся для услуги салона, чтобы получить слоты выбранного мастера.

Example:master_user_id=40
salon_idinteger, (int64), >= 1

ID салона для получения объединённых слотов всех мастеров, назначенных на услугу. Нельзя передавать одновременно с master_user_id.

Example:salon_id=5
datestring, (date)required

Дата, начиная с сегодняшнего дня.

Example:date=2026-03-13
curl -i -X GET \
  'https://felmee.com/api/record/free-slots?service_id=20&master_user_id=40&salon_id=5&date=2026-03-13' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Список слотов успешно получен

Bodyapplication/json
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

successbooleanrequired

Флаг успешного выполнения запроса

messagestringrequired

Человекочитаемое описание результата

error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
dataobject or null(RecordGetFreeSlotsData)required

Полезная нагрузка. Может быть объектом, массивом или null.

Response
{ "success": true, "message": "Free slots retrieved successfully", "codeError": null, "error_code": null, "data": { "free_slots": [ … ] } }