Создает новую услугу текущего мастера или участника салона.
Для индивидуального мастера 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 до 100000discount_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должны иметь purposeCARD - требуется 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.
Для салонной услуги передайте master_user_ids, например [22, 23], чтобы сразу назначить выбранных мастеров.
Базовая цена по умолчанию. Используется, если price_intervals отсутствуют или проверяемое время не попадает ни в один интервал.
Только для услуг с is_fix_price=true. Интервалы не должны пересекаться. Если поле не передано или передан пустой массив, используется только price. При is_fix_price=false поле запрещено, включая пустой массив; ответ 400 invalid_body.
[ { "start_time": "10:00", "end_time": "12:00", "price": 2000 } ]
Процент скидки услуги, который можно задать сразу при создании через POST /api/service.
Правила:
0сохраняется как0и означает отсутствие скидки1..100устанавливает скидку услуги в процентах- если поле не передано или передано
null, услуга создается без скидки - скидку можно задать как для фиксированной цены, так и для цены «от» (
is_fix_price=false)
При false цена услуги считается ценой «от»; price_intervals задавать нельзя, discount_percent разрешён.
Ordered service image IDs. The first image is used as preview. All files must have purpose CARD.
[ 101, 102, 103 ]
Для SALON только отсутствие или null; любое ненулевое значение, включая пустую строку, даёт 400 invalid_body. Для MASTER адрес задаётся в каждом service_locations[].address; если верхнее поле передано, вместе с ним обязательна geolocation.
Для SALON не передаётся. Для MASTER обязательна при передаче верхнего address.
Обязательно для индивидуального мастера. Содержит объекты с адресом и метаданными каждого места оказания. Для салонной услуги поле запрещено, потому что она использует местоположение салона.
Необязательные фразы для поиска внутри приложения. Возвращаются в GET карточки услуги, но не отображаются в её интерфейсе.
[ "Брови", "Окрашивание бровей" ]
Только для услуги салона. Массив users.id мастеров этого же салона с любым статусом, включая PENDING_DELETE; услуга привязывается к ним при создании в одной транзакции. Пустой массив означает услугу без мастеров. Для услуги индивидуального мастера поле запрещено.
[ 22, 23 ]
- https://felmee.comhttps://felmee.com/api/service
- http://localhost:8080http://localhost:8080/api/service
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
]
}'Услуга успешно создана
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
{ "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": { … } } }