Skip to content

Создать мастера салона

Request

first_name и last_name содержат только русские буквы А–Я, а–я, Ё, ё: от 1 до 100 символов, без пробелов и знаков препинания.

Создает профиль мастера внутри салона.

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

  • first_name обязателен, не должен быть пустым и не должен быть длиннее 100 символов
  • 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
Bodyapplication/jsonrequired
first_namestring, [ 1 .. 100 ] characters.*\S.*required
last_namestring, [ 1 .. 100 ] characters.*\S.*required
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, <= 10 items, unique

ID карточек мастера. Все файлы должны принадлежать пользователю и иметь purpose CARD.

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

Опыт работы мастера в годах.

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

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

min_booking_lead_time_minutesinteger or null, (int32), >= 0
break_after_service_mininteger or null, (int32), >= 0
curl -i -X POST \
  https://felmee.com/api/salon/master \
  -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": "Hair master with salon and client appointments.",
    "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(CreateSalonMasterData)required

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

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