Skip to content

Заполнить или изменить салон

Request

Частично заполняет или изменяет салон текущего пользователя.

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

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

  • должен быть заполнен хотя бы один корректный field
  • name, если передан, не должен быть пустым и не должен быть длиннее 100 символов
  • cover_photo_id, если передан, должен быть положительным ID файла
  • cover_photo_id должен принадлежать текущему пользователю и иметь purpose CARD
  • city, если передан, не должен быть пустым и не должен быть длиннее 30 символов
  • если передан city, обязательно должна быть передана geolocation; geolocation без city разрешена
  • address, если передан, не должен быть пустым и не должен быть длиннее 1000 символов
  • geolocation, если передан, должен содержать lat и lon
  • geolocation.lat должен быть в диапазоне [-90, 90], geolocation.lon - в диапазоне [-180, 180]
  • если переданы address и geolocation, backend сохраняет оба значения напрямую без повторного геокодирования
  • если передан address без полной geolocation с lat и lon, возвращается 400 invalid_body
  • если передана geolocation без address и без city, backend выполняет обратное геокодирование и сохраняет найденный адрес
  • если переданы city и geolocation без address, backend сохраняет координаты напрямую, а address устанавливает равным city
  • contact_phone, если передан, должен быть не длиннее 32 символов и после стандартизации содержать 11 цифр с первой цифрой 7
  • description, если передан, не должен быть пустым и не должен быть длиннее 1000 символов
  • interior_description, если передан, не должен быть пустым и не должен быть длиннее 1000 символов
  • category_ids, если передан, должен быть массивом уникальных положительных ID существующих категорий
  • advantages, если передан, должен содержать уникальные непустые строки, не больше 5 элементов, каждый элемент не длиннее 50 символов
  • interior_images, если передан, должен содержать уникальные положительные ID файлов и не больше 10 элементов
  • все файлы из interior_images должны принадлежать текущему пользователю и иметь purpose CARD
  • amenities, если передан, должен содержать уникальные значения enum и не больше 4 элементов
  • working_days, если передан, должен содержать ровно 7 элементов от MONDAY до SUNDAY по порядку
  • для рабочего дня working = true обязательны start_time и end_time
  • для выходного дня working = false start_time и end_time должны быть null
  • end_time должен быть позже start_time, длительность рабочего интервала не меньше 30 минут

Требования:

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

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

Security
bearerAuth or jwtCookie
Bodyapplication/jsonrequired
namestring or null, [ 1 .. 100 ] characters.*\S.*
cover_photo_idinteger or null, (int64), >= 1

ID файла обложки. Файл должен принадлежать пользователю и иметь purpose CARD.

citystring or null, [ 1 .. 30 ] characters.*\S.*
addressstring or null, [ 1 .. 1000 ] characters.*\S.*

При передаче адреса обязательна geolocation с lat и lon.

geolocation(ProfileGeolocation (object or null))
One of:
contact_phonestring or null, [ 1 .. 32 ] characters

Контактный телефон салона.

descriptionstring or null, [ 1 .. 1000 ] characters.*\S.*
interior_descriptionstring or null, [ 1 .. 1000 ] characters.*\S.*
category_idsArray of integers or null, unique

ID существующих категорий салона.

advantagesArray of strings or null, <= 5 items, unique

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

interior_imagesArray of integers or null, <= 10 items, unique

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

amenitiesArray of strings or null, <= 4 items, unique
working_daysArray of objects or null, = 7 items(SalonWorkingDay)

Ровно 7 дней, в порядке MONDAY -> SUNDAY.

curl -i -X PATCH \
  https://felmee.com/api/salon \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Persona",
    "cover_photo_id": 42,
    "city": "Minsk",
    "address": "Minsk, Nezavisimosti 1",
    "geolocation": {
      "lat": 53.9,
      "lon": 27.56
    },
    "contact_phone": "+79991234567",
    "description": "Beauty salon in the city center.",
    "interior_description": "Bright studio with separate manicure rooms.",
    "category_ids": [
      1,
      2
    ],
    "advantages": [
      "Parking",
      "Wi-Fi"
    ],
    "interior_images": [
      201,
      202
    ],
    "amenities": [
      "PARKING",
      "TEA_COFFEE"
    ],
    "working_days": [
      {
        "day_of_week": "MONDAY",
        "working": true,
        "start_time": "09:00",
        "end_time": "18:00"
      },
      {
        "day_of_week": "TUESDAY",
        "working": true,
        "start_time": "09:00",
        "end_time": "18:00"
      },
      {
        "day_of_week": "WEDNESDAY",
        "working": true,
        "start_time": "09:00",
        "end_time": "18:00"
      },
      {
        "day_of_week": "THURSDAY",
        "working": true,
        "start_time": "09:00",
        "end_time": "18:00"
      },
      {
        "day_of_week": "FRIDAY",
        "working": true,
        "start_time": "09:00",
        "end_time": "18:00"
      },
      {
        "day_of_week": "SATURDAY",
        "working": false,
        "start_time": null,
        "end_time": null
      },
      {
        "day_of_week": "SUNDAY",
        "working": false,
        "start_time": null,
        "end_time": null
      }
    ]
  }'

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

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

Response
{ "success": true, "message": "Salon updated successfully", "codeError": null, "error_code": null, "data": { "changed": true, "id": 10, "qr_id": 43, "name": "Persona", "description": "Beauty salon in the city center.", "interior_description": "Bright studio with separate manicure rooms.", "city": "Minsk", "address": "Minsk, Nezavisimosti 1", "geolocation": { … }, "contact_phone": "+375291112233", "cover_photo_id": 42, "category_ids": [ … ], "advantages": [ … ], "interior_images": [ … ], "amenities": [ … ], "working_days": [ … ], "rating": 4.27 } }