Skip to content

Изменить мастера салона

Request

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

Изменять можно только мастера, который принадлежит тому же салону. Если переданные значения совпадают с уже сохраненными, backend возвращает changed = false и сообщение No changes were made to the salon master.

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

  • должен быть заполнен хотя бы один корректный field
  • first_name, last_name, если переданы, не должны быть пустыми и не должны быть длиннее 100 символов
  • avatar, если передан, должен быть положительным ID файла
  • avatar должен принадлежать текущему пользователю и быть допустимым для установки как аватар
  • category_ids, если передан, должен быть массивом уникальных положительных ID существующих категорий
  • example_work_images, если передан, должен содержать уникальные положительные ID файлов и не больше 10 элементов
  • все файлы из example_work_images должны принадлежать текущему пользователю и иметь purpose CARD
  • experience_years, если передан, должен быть в диапазоне от 0 до 60
  • description, если передан, не должен быть пустым и не должен быть длиннее 1000 символов
  • advantages, если передан, должен содержать уникальные непустые строки, не больше 5 элементов, каждый элемент не длиннее 50 символов
  • min_booking_lead_time_minutes, если передан, должен быть больше или равен 0
  • break_after_service_min, если передан, должен быть больше или равен 0

Требования:

  • требуется JWT
  • текущий пользователь должен быть владельцем или администратором салона

Готовность прикрепляемых файлов: Для avatar требуется purpose AVATAR, для example_work_images — CARD. Все переданные файлы должны иметь статус UPLOADED. PENDING и FAILED не принимаются при прикреплении новых файлов. Проверки доступа, владельца и прочие ограничения операции сохраняются. Перед отправкой дождитесь успешного ответа POST /api/file/upload.

Security
bearerAuth or jwtCookie
Path
idinteger, (int64), >= 1required

ID salon_masters.id.

Example:15
Bodyapplication/jsonrequired
first_namestring or null, [ 1 .. 100 ] characters.*\S.*
last_namestring or null, [ 1 .. 100 ] characters.*\S.*
avatarinteger or null, (int64), >= 1

ID файла, который принадлежит пользователю и может быть установлен как аватар.

category_idsArray of integers or null, unique

Category IDs of services provided by the salon master. All IDs must be positive and must exist.

example_work_imagesArray of integers or null, [ 0 .. 10 ] items, unique

ID карточек мастера. Все файлы должны принадлежать пользователю и иметь purpose CARD. Пустой массив очищает список; null или отсутствие поля сохраняет прежнее значение.

experience_yearsinteger or null, (int64), [ 0 .. 720 ]

Опыт работы мастера в месяцах.

descriptionstring or null, [ 1 .. 1000 ] characters.*\S.*
advantagesArray of strings or null, [ 0 .. 5 ] items, unique

Преимущества мастера. Каждый элемент должен быть непустой строкой длиной до 50 символов. Пустой массив очищает список; null или отсутствие поля сохраняет прежнее значение.

min_booking_lead_time_minutesinteger or null, (int32), >= 0
break_after_service_mininteger or null, (int32), >= 0
curl -i -X PATCH \
  https://felmee.com/api/salon/master/15 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "Анна",
    "last_name": "Иванова",
    "avatar": 42,
    "category_ids": [
      1,
      2
    ],
    "example_work_images": [
      101,
      102
    ],
    "experience_years": 50,
    "description": "Updated salon master description.",
    "advantages": [
      "Parking",
      "Wi-Fi"
    ],
    "min_booking_lead_time_minutes": 60,
    "break_after_service_min": 15
  }'

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

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

Response
{ "success": true, "message": "Salon master updated successfully", "codeError": null, "error_code": null, "data": { "changed": true, "salon_master": { … } } }