PUT - Обновить пользователя по ID
Описание
Метод PUT /users/{id} позволяет обновить данные конкретного пользователя по его уникальному идентификатору (ID). Для доступа к этому методу требуется авторизация, и в заголовке должен быть указан действительный токен.
Авторизация
| Заголовок | Описание | Пример |
|---|---|---|
| Authorization | Токен для авторизации. | Authorization: {token} |
Примечание:
- Токены генерируются на веб-сайте и должны передаваться с каждым запросом.
- Если токен недействителен или истек, сервер вернет ошибку авторизации.
Параметры пути
| Параметр | Описание | Пример |
|---|---|---|
| id (UUID) | Уникальный идентификатор пользователя. | be63c536-6cf3-4866-8970-37a956e3f403 |
Тело запроса
| Поле | Тип | Описание | Обязательно |
|---|---|---|---|
| firstName | строка | Имя пользователя. | Да |
| middleName | строка | Отчество пользователя. | Нет |
| lastName | строка | Фамилия пользователя. | Да |
| employeeNo | строка | Номер сотрудника. | Нет |
| employeePin | строка | ПИН сотрудника. | Нет |
| строка | Адрес электронной почты пользователя. | Да | |
| phone | строка | Номер телефона пользователя. | Да |
| language | строка | Предпочитаемый язык пользователя (например, ru). | Нет |
| role | строка | Роль пользователя (например, ADMIN). | Да |
| locationIds | массив строк | Список идентификаторов местоположений, связанных с пользователем. | Нет |
| tags | массив строк | Теги, связанные с пользователем. | Нет |
Пример запроса
PUT /users/be63c536-6cf3-4866-8970-37a956e3f403
Authorization: abcdef1234567890
Content-Type: application/json
{
"firstName": "John",
"lastName": "Fox",
"email": "fox.john@gmail.com",
"phone": "80291110099",
"role": "ADMIN"
}
Пример ошибки авторизации
Ответ с ошибкой:
- Код:
401 Unauthorized - Тело ответа:
{
"message": "invalid or missing token",
"code": "auth.token.invalid",
"timestamp": "2023-03-07T05:57:59.315Z"
} - Описание: Эта ошибка возникает, если заголовок
Authorizationотсутствует или токен недействителен/истек.