Метод: Обновление информации о пользователе

Метод служит для обновления информации о пользователе на платформе promotivation.

URL

 POST {домен}/api/v2/user/change

Описание

Метод служит для обновления информации о пользователе на платформе promotivation.

Структура запроса

Пример запроса

Формат запроса:

POST {домен}/api/v2/user/change

"Authorization: Bearer 1jijdsaohdiadibbcsanco……"
"Content-Type: application/json"

{
  "idExternal": "dkfsa124ksad",
  "surname": "Иванов",
  "name": "Иван",
  "patronymic": "Иванович",
  "birthday": "01.01.2001",
  "phone": "9139134466",
  "mai": "mail@mail.ru",
  "innCompany": "1234567890",
}

Параметры запроса

Параметр	Тип	Описание	Обязательный	Шифрование
`Authorization`	string	Уникальный токен аутентификации	Да	Нет
`idExternal`	string	Внешний идентификатор пользователя. До 30 символов.	Нет	Да
`surname`	string	Фамилия пользователя. До 30 символов.	Да	Да
`name`	string	Имя пользователя. До 30 символов.	Да	Да
`patronymic`	string	Отчество пользователя. До 30 символов.	Нет	Да
`birthday`	string	Дата рождения пользователя. До 10 символов.В формате ДД.ММ.ГГГГ.	Нет	Да
`phone`	int	Телефон пользователя. До 10 символов. Начиная с 9 (без кода страны)	Да (в случае, если используется в качестве логина)	Да
`mail`	string	E-mail пользователя. До 30 символов. Уникальное значение в рамках Партнера.	Да (в случае, если используется в качестве логина)	Да
`innCompany`	string	Инн компании сотрудника. От 10 до 12 символов, только цифры.	Нет	Да

Структура ответа

Пример успешного ответа

{
  "status": "OK",
  "idExternal": "skjbsvb8fb3fiw"
}

Параметры успешного ответа

Параметр	Тип	Описание
`status`	string	Статус
`idExternal`	string	Внешний идентификатор пользователя (если рне был передан)

Пример ответа с ошибкой

{
  "status": "INVALID_FIELDS",
  "message: " The fields are uncorrected quantity, offset ".
}

Параметры ответа с ошибками

Параметр	Тип	Описание
`status`	string	Статус ошибки
`message`	string	Информационное сообщение

Возможные ошибки

Статус	Описание
`INVALID_FIELDS`	Некорректное поле. Поле не соответствует требованиям.
`USER_NOT_FOUND`	Пользователь не найден
`USER_EXISTS`	Пользователь с данным внешним идентификатором существует в системе.
`EMAIL_EXISTS`	Пользователь с таким email существует.
`PHONE_NUMBER_EXISTS`	Пользователь с таким номером телефона существует.
`TOKEN_ERROR`	Токен не найден