Skip to content

Обновить профиль текущего пользователя

Request

Обновляет профиль текущего авторизованного пользователя.

Можно передать любое из полей:

  • first_name
  • last_name
  • city
  • avatar
  • geolocation
  • category_ids

Особенности валидации:

  • хотя бы одно поле должно быть заполнено; каждое переданное ненулевое поле должно пройти валидацию
  • first_name и last_name содержат только русские буквы, от 1 до 100 символов
  • category_ids не допускает повторяющихся ID
  • geolocation валиден только если переданы оба поля: lat и lon
  • если передан city, обязательно должна быть передана geolocation; geolocation без city разрешена
  • только у CLIENT при уже сохранённой полной геолокации повторно переданные city и geolocation игнорируются; для других типов аккаунтов локацию можно обновлять
  • при передаче city и geolocation backend сохраняет выбранные координаты без повторного геокодирования, а address устанавливает равным city
  • address является вычисляемым полем и напрямую в запросе не принимается
  • для avatar проверяется доступ пользователя к файлу и возможность использовать файл как аватар
  • category_ids, если передан, должен быть массивом существующих ID категорий; пустой массив допустим
  • category_ids у пользователя используется для рекомендаций

Требования:

  • требуется JWT

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

Security
bearerAuth or jwtCookie
Bodyapplication/jsonrequired
first_namestring or null, [ 1 .. 100 ] characters^[А-Яа-яЁё]+$
last_namestring or null, [ 1 .. 100 ] characters^[А-Яа-яЁё]+$
citystring or null, [ 1 .. 30 ] characters.*\S.*
avatarinteger or null, (int64), >= 1

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

geolocationobject or null(ProfileGeolocation)
category_idsArray of integers, unique

Category IDs used for personalized recommendations for the user. When the field is provided, it must be an array. An empty array is allowed and clears the saved preferences. All IDs must exist.

curl -i -X PATCH \
  https://felmee.com/api/user \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "Иван",
    "last_name": "Иванов"
  }'

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

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

Response
{ "success": true, "message": "User updated successfully", "codeError": null, "error_code": null, "data": { "changed": true, "user": { … } } }