Частично обновляет услугу по ее идентификатору.
При изменении is_fix_price в любую сторону ожидающие предложения новой записи этой услуги (CREATE_RECORD со статусом WAITING_APPROVE) автоматически переходят в EXPIRED в той же транзакции. Чат обновляет статус и отправляет /user/queue/chat.update_status_request со значением EXPIRED участникам диалога. Для записи на новых условиях требуется новое предложение. Изменение цены без смены типа не отменяет предложения автоматически. Уже принятые предложения WAITING_FOR_PAYMENT и созданные записи сохраняются.
Для роли SALON проверка доступа к услуге выполняется через владельца салона: backend находит салон текущего пользователя, получает id владельца салона и проверяет, что услуга принадлежит этому owner id. Файлы из images по-прежнему проверяются по текущему пользователю, который отправил запрос. Для салонной услуги master_user_ids содержит users.id мастеров, которые должны оказывать услугу после изменения. Переданный список полностью заменяет текущие привязки в той же транзакции: [] снимает всех мастеров, отсутствие поля сохраняет их. Для индивидуального мастера передавать master_user_ids нельзя. Администратору салона требуется SERVICE_MANAGE.
Правила валидации:
- хотя бы одно поле должно быть заполнено корректно
name, если передан, не должен быть пустым и не должен быть длиннее 120 символовpriceдолжен быть в диапазоне от 1 до 100000discount_percentменяет скидку услуги:nullудаляет скидку (в ответе тожеnull),0сохраняется как0и означает отсутствие скидки, значения1..100устанавливают скидку, отсутствие поля не меняет текущую скидку- при итоговом
is_fix_price=falseполеprice_intervalsзапрещено, включая пустой массив; скидкаdiscount_percentразрешена - переключение
is_fix_priceнаfalseудаляет сохранённые интервалы цены и сохраняет скидку durationдолжен быть в диапазоне от 1 до 1440 минутdescription, если передан, не должен быть пустым и не должен быть длиннее 4000 символовcategory_id, если передан, должен быть положительным ID существующей конечной подкатегории- корневую категорию или категорию с дочерними категориями нельзя назначить услуге
- если передан
images, он должен содержать от 1 до 10 уникальных положительных ID файлов в порядке клиента - если передан
images, все файлы должны иметь purposeCARD - для услуги индивидуального мастера
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; она использует адрес и координаты самого салона, а передача любого из этих полей приводит к400 invalid_body master_user_ids, если передан, содержит уникальные положительныеusers.idмастеров того же салона; допустим любой статус мастера, включаяPENDING_DELETE
Доступ:
- требуется JWT
- мастер должен иметь доступ к услуге как ее владелец
- владелец или админ салона должен иметь доступ к услуге через owner id салона
- если передан
images, все файлы должны быть доступны пользователю
Готовность прикрепляемых файлов: Все переданные images должны иметь purpose CARD и статус UPLOADED. PENDING и FAILED не принимаются при прикреплении новых файлов. Проверки доступа, владельца и прочие ограничения операции сохраняются. Перед отправкой дождитесь успешного ответа POST /api/file/upload.
Для салонной услуги master_user_ids заменяет весь набор назначенных мастеров; [] удаляет все привязки.
Базовая цена по умолчанию. Используется, если price_intervals отсутствуют или проверяемое время не попадает ни в один интервал.
Только для услуг с итоговым is_fix_price=true. Если поле не передано, текущие интервалы не изменяются. Пустой массив удаляет все интервалы. При итоговом is_fix_price=false поле запрещено, включая пустой массив; ответ 400 invalid_body.
Процент скидки услуги.
Используется в PATCH /api/service/{serviceId} как обычное поле обновления услуги. Отдельного endpoint для установки скидки нет.
Правила:
nullудаляет скидку; в ответеdiscount_percentбудетnull0сохраняется как0и означает, что скидка снята1..100устанавливает скидку в процентах- если поле не передано, текущая скидка не меняется
- значения меньше
0и значения больше100не являются валидной скидкой - скидку можно менять как для фиксированной цены, так и для цены «от» (
is_fix_price=false)
При переключении на false сохранённые price_intervals удаляются, а скидка сохраняется. При итоговом is_fix_price=false поле price_intervals запрещено; discount_percent разрешено.
Ordered service image IDs. The first image is used as preview. All files must have purpose CARD.
Для индивидуального мастера при передаче этого поля обязательна geolocation; адрес каждого места задаётся в service_locations.
Для индивидуального мастера обязательна при передаче верхнего address.
Места оказания индивидуальной услуги. Каждый элемент содержит собственный адрес и обязательные координаты. Для салонной услуги поле запрещено.
Необязательные фразы для поиска. Отсутствие поля не меняет список; пустой массив очищает его.
Только для услуги салона. Массив users.id мастеров этого же салона с любым статусом, включая PENDING_DELETE. Заменяет весь список привязок в той же транзакции, что и остальные изменения. Отсутствие поля сохраняет прежние привязки; пустой массив удаляет их. Для услуги индивидуального мастера поле запрещено.
[ 22, 23 ]
- https://felmee.comhttps://felmee.com/api/service/{service_id}
- http://localhost:8080http://localhost:8080/api/service/{service_id}
curl -i -X PATCH \
'https://felmee.com/api/service/{service_id}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"name": "Мужская стрижка премиум",
"price": 1800,
"master_user_ids": [
22,
23
]
}'Услуга успешно обработана
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
{ "success": true, "message": "Service updated successfully", "codeError": null, "error_code": null, "data": { "changed": true, "service": { … } } }