Skip to content

Изменение информации о сотруднике

Метод служит для изменения информации о сотруднике.

URL

PUT https://rest.lksup.ru/v1/employee/{idEmployee}

Описание

Метод позволяет изменить текущую информацию о сотруднике.

Для выполнения запроса необходимо передать:
- Параметры сотрудника — информацию о сотруднике.
- Авторизационные данные — JWT access токен. - X-Nonce: — значение состоит из случайных символов, используется в шифровании (передается в заголовке)

Примечание: Убедитесь, что переданные данные корректны и шифруются в соответствии с требованиями API.

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

В HTTP Header необходимо передать x-nonce, также в заголовок Authorization, помещается JWT токен. В тело запроса помещаются, предварительно зашифрованные данные о сотруднике. idEmployee передается в path параметр.

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

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

PUT https://rest.lksup.ru/v1/employee/{idEmployee}

Тело запроса

{
    "customId": "45678900",
    "surname": "Иванов",
    "name": "Иван",
    "patronymic": "Иванович",
    "phone": "9123456789",
    "email": "example@mail.ru",
    "idCategory": "7f21773d-1d88-4fb0-835a-a4db53befd45",
    "status": "WORK"
}

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

Параметр Тип Описание Обязательный Шифрование
idEmployee uuid Уникальный идентификатор сотрудника в сервисе СУП Да Да
customId string(64) Уникальный идентификатор сотрудника в системе партнера.
Длина 64 символа, допустимые значения строчные и заглавные а-я, a-z, 0-9, символы “-” и “_”		 Нет Да
surname string(32) Фамилия сотрудника.
Длина 32 символа, допустимые значения строчные и заглавные а-я, a-z, символ “-”		 Нет Да
name string(32) Имя сотрудника.
Длина 32 символа, допустимые значения строчные и заглавные а-я, a-z, символ “-”		 Нет Да
patronymic string(32) Отчество сотрудника.
Длина 32 символа, допустимые значения строчные и заглавные а-я, a-z, символ “-”		 Нет Да
phone string(10) Номер телефона сотрудника (без указания кода страны) Нет Да
email string Почта сотрудника Нет Да
idCategory uuid Идентификатор категории Нет Да
status string Статус сотрудника. Нет Да

Возможные значения для параметра status:

Наименование Описание
WORK Работает (значение по умолчанию при создании сотрудника)
VACATION В отпуске
MEDICAL На больничном
DONT_WORK Не работает, перемещен в архив

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

Пример успешного ответа - код 200

{
   "idEmployee": "7f21773d-1d88-4fb0-835a-a4db53befd45",
    "customId": "45678900",
    "surname": "Иванов",
    "name": "Иван",
    "patronymic": "Иванович",
    "phone": "9123456789",
    "email": "example@mail.ru",
    "idCategory": "7f21773d-1d88-4fb0-835a-a4db53befd45",
    "status": "WORK",
    "createdAt": "01.01.2025",
    "statusUpdatedAt": "05.01.2025"
}

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

Параметр Тип Описание
idEmployee uuid Идентификатор сотрудника в сервисе СУП
customId string Идентификатор сотрудника в системе партнера
surname string Фамилия сотрудника
name string Имя сотрудника
patronymic string Отчество сотрудника
phone string Номер телефона сотрудника
email string Электронная почта сотрудника
idCategory uuid Идентификатор категории
status string Статус сотрудника
createdAt string Дата добавления сотрудника в сервис СУП
statusUpdateAt string Дата обновления статуса сотрудника

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

Ответы с ошибкой могут быть двух видов.

Пример ответа для кода состояния 422

{
  "data": [{
            "field":"string",
            "message":"string"
            },
            {
            "field":"string",
            "message":"string"
            }]
}

Пример ответа для кодов состояния 4хх, за исключением 422

{
  "message": "string"
}

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

Параметр Тип Описание
field string Наименование поля, в котором была допущена ошибка
message string Текстовое описание ошибки

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

Статус Описание
401 Не авторизован. Токен не прошел валидацию
404 Сотрудник с таким idEmployee не найден
422 Переданно некорректное значение