Skip to content

Создать услугу

Request

Создает новую услугу текущего мастера или участника салона.

Для индивидуального мастера provider_id созданной услуги равен id текущего пользователя. Для роли SALON backend находит салон текущего пользователя, получает id владельца салона и записывает его в provider_id услуги. Это относится и к владельцу салона, и к админу салона. В публичном ответе provider_id салонной услуги содержит salons.id, а provider_type — SALON. В master_user_ids можно передать users.id мастеров этого же салона: услуга сразу привяжется к ним в одной транзакции. Пустой массив создаёт услугу без мастеров. Для индивидуального мастера поле master_user_ids передавать нельзя. Администратору салона требуется SERVICE_MANAGE.

Правила валидации:

  • name не должен быть пустым и не должен быть длиннее 120 символов
  • description не должен быть пустым и не должен быть длиннее 4000 символов
  • price должен быть в диапазоне от 1 до 100000
  • discount_percent, если передан в POST /api/service, должен быть в диапазоне от 0 до 100; 0 означает отсутствие скидки, 1..100 задает скидку услуги при создании
  • при is_fix_price=false поле price_intervals запрещено, в том числе пустой массив; скидка discount_percent разрешена
  • duration должен быть в диапазоне от 1 до 1440 минут
  • category_id должен быть положительным ID существующей конечной подкатегории
  • корневую категорию или категорию с дочерними категориями нельзя назначить услуге
  • images должен содержать от 1 до 10 уникальных положительных ID файлов в порядке клиента
  • для индивидуального мастера service_locations обязателен и должен содержать от 1 до 3 объектов с уникальными service_location: IN_SALON, AT_MASTER_PLACE, CLIENT_PLACE
  • в каждом объекте service_locations обязателен непустой address
  • в каждом объекте обязательна полная geolocation с lat и lon; координаты сохраняются напрямую без повторного геокодирования
  • для IN_SALON обязателен непустой salon_name
  • для CLIENT_PLACE обязателен radius_km со значением 1, 5, 10 или 20
  • салонная услуга использует адрес и координаты самого салона; поля service_locations, address и geolocation для роли SALON должны отсутствовать или быть null; любое ненулевое значение, включая пустую строку address, приводит к 400 invalid_body
  • advantages должен содержать не больше 5 уникальных непустых строк до 50 символов
  • master_user_ids, если передан, содержит уникальные положительные users.id мастеров того же салона; допустим любой статус мастера, включая PENDING_DELETE

Доступ:

  • только роли MASTER или SALON
  • файлы из images должны быть доступны текущему пользователю
  • файлы из images должны иметь purpose CARD
  • требуется JWT

Ожидание изображений при создании (MASTER, SALON OWNER и SALON ADMIN с SERVICE_MANAGE):

  • права на файлы и purpose CARD проверяются до ожидания; чужие файлы и неверный purpose сразу дают 403
  • backend ожидает UPLOADED для всех images до 5 секунд суммарно, а не по 5 секунд на файл
  • если все фото готовы раньше, создание продолжается сразу; при успехе возвращается 201
  • FAILED или удаление файла во время ожидания: 422 file_upload_failed; услуга не создаётся
  • PENDING через 5 секунд: 408 file_upload_timeout; услуга не создаётся, запрос можно повторить позже
  • 5 секунд — предел ожидания фото; полное выполнение запроса может занять дополнительное время

Готовность прикрепляемых файлов: для images требуется purpose CARD. Сервер ожидает UPLOADED всех фотографий до 5 секунд суммарно. FAILED или удаление во время ожидания дают 422 file_upload_failed, незавершённая загрузка через 5 секунд — 408 file_upload_timeout. До готовности всех фото услуга не сохраняется. Для новых файлов успешный ответ POST /api/file/upload уже гарантирует UPLOADED.

Security
bearerAuth or jwtCookie
Bodyapplication/jsonrequired

Для салонной услуги передайте master_user_ids, например [22, 23], чтобы сразу назначить выбранных мастеров.

namestring, [ 1 .. 120 ] characters.*\S.*required
Example:"Мужская стрижка"
priceinteger, (int32), [ 1 .. 100000 ]required

Базовая цена по умолчанию. Используется, если price_intervals отсутствуют или проверяемое время не попадает ни в один интервал.

Example:1500
price_intervalsArray of objects or null(ServicePriceInterval)

Только для услуг с is_fix_price=true. Интервалы не должны пересекаться. Если поле не передано или передан пустой массив, используется только price. При is_fix_price=false поле запрещено, включая пустой массив; ответ 400 invalid_body.

Example:
[ { "start_time": "10:00", "end_time": "12:00", "price": 2000 } ]
discount_percentinteger or null, (int32), [ 0 .. 100 ]

Процент скидки услуги, который можно задать сразу при создании через POST /api/service.

Правила:

  • 0 сохраняется как 0 и означает отсутствие скидки
  • 1..100 устанавливает скидку услуги в процентах
  • если поле не передано или передано null, услуга создается без скидки
  • скидку можно задать как для фиксированной цены, так и для цены «от» (is_fix_price=false)
Example:15
durationinteger, (int32), [ 1 .. 1440 ]required

Длительность услуги в минутах.

Example:60
descriptionstring, [ 1 .. 4000 ] characters.*\S.*required
Example:"Стрижка с мытьем головы и укладкой."
category_idinteger, (int64), >= 1required
Example:3
is_fix_pricebooleanrequired

При false цена услуги считается ценой «от»; price_intervals задавать нельзя, discount_percent разрешён.

Example:true
imagesArray of integers, [ 1 .. 10 ] items, uniquerequired

Ordered service image IDs. The first image is used as preview. All files must have purpose CARD.

Example:
[ 101, 102, 103 ]
addressstring or null

Для SALON только отсутствие или null; любое ненулевое значение, включая пустую строку, даёт 400 invalid_body. Для MASTER адрес задаётся в каждом service_locations[].address; если верхнее поле передано, вместе с ним обязательна geolocation.

geolocationobject or null(ProfileGeolocation)

Для SALON не передаётся. Для MASTER обязательна при передаче верхнего address.

service_locationsArray of objects or null, [ 1 .. 3 ] items, unique(ServiceLocationRequest)

Обязательно для индивидуального мастера. Содержит объекты с адресом и метаданными каждого места оказания. Для салонной услуги поле запрещено, потому что она использует местоположение салона.

advantagesArray of strings, <= 5 itemsrequired
Example:
[ "Стерильные инструменты", "Быстро" ]
seo_queriesArray of strings, <= 10 items, unique

Необязательные фразы для поиска внутри приложения. Возвращаются в GET карточки услуги, но не отображаются в её интерфейсе.

Example:
[ "Брови", "Окрашивание бровей" ]
master_user_idsArray of integers, unique

Только для услуги салона. Массив users.id мастеров этого же салона с любым статусом, включая PENDING_DELETE; услуга привязывается к ним при создании в одной транзакции. Пустой массив означает услугу без мастеров. Для услуги индивидуального мастера поле запрещено.

Example:
[ 22, 23 ]
curl -i -X POST \
  https://felmee.com/api/service \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Мужская стрижка",
    "price": 1500,
    "duration": 60,
    "description": "Стрижка с мытьем головы и укладкой.",
    "category_id": 3,
    "is_fix_price": true,
    "images": [
      101,
      102,
      103
    ],
    "advantages": [
      "Стерильные инструменты",
      "Быстро"
    ],
    "seo_queries": [
      "Барберская стрижка",
      "Стрижка машинкой"
    ],
    "master_user_ids": [
      22,
      23
    ]
  }'

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(ServiceResponse)required

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

Response
{ "success": true, "message": "Service created successfully", "codeError": null, "error_code": null, "data": { "id": 20, "images": [ … ], "name": "Мужская стрижка", "price": 1500, "price_intervals": [ … ], "base_price": 1500, "final_price": 1275, "discount_percent": 15, "duration": 60, "description": "Стрижка с мытьем головы и укладкой.", "category_id": 3, "parent_category_id": 1, "provider_id": 5, "provider_type": "SALON", "provider_name": "Beauty Salon", "is_fix_price": true, "rating": null, "reviews_count": 0, "masters": [ … ], "service_locations": [ … ], "address": "г. Москва, ул. Тверская, д.16", "advantages": [ … ], "seo_queries": [ … ], "geo": { … } } }