Метод для получения информации о сотруднике.
Для получения сотрудника вам необходимо знать его id и указать его в URL запроса.
|
Запрос
|
|||
|---|---|---|---|
| Параметры запроса отсутствуют | |||
|
Ответ
|
|||
| data | object | Информация о сотруднике | |
| id | integer | Идентификатор пользователя | |
| first_name | string | Имя | |
| last_name | string | Фамилия | |
| nickname | string | Имя пользователя | |
| string | Электронная почта | ||
| phone_number | string | Телефон | |
| department | string | Департамент | |
| title | string | Должность | |
| role | string | Уровень доступа: admin (администратор), user (сотрудник), multi_guest (мульти-гость) | |
| suspended | boolean | Деактивация пользователя. При значении true пользователь является деактивированным. | |
| invite_status | string | Статус пришлашения: confirmed (принято), sent (отправлено) | |
| list_tags | array of strings | Массив тегов, привязанных к сотруднику | |
| custom_properties | array of objects | Дополнительные поля сотрудника | |
| id | integer | Идентификатор поля | |
| name | string | Название поля | |
| data_type | string | Тип поля (string, number, date или link) | |
| value | string | Значение | |
| user_status | object или null | Статус. Возвращается как null, если статус не установлен. | |
| emoji | string | Emoji символ статуса | |
| title | string | Текст статуса | |
| expires_at | string или null | Срок жизни статуса (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ. Возвращается как null, если срок не установлен. | |
| bot | boolean | Тип: пользователь (false) или бот (true) | |
| sso | boolean | Single Sign-On авторизация. При значени true пользователь для входа использует SSO. | |
| created_at | string | Дата создания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ | |
| last_activity_at | string | Дата последней активности пользователя (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ | |
| time_zone | string | Часовой пояс пользователя | |
| image_url | string или null | Ссылка на скачивание аватарки пользователя | |
|
Возможные ошибки запроса (errors code)
|
|||
| not_found | Не удалось найти | ||
{
"data": {
"id": 12,
"first_name": "Олег",
"last_name": "Петров",
"nickname": "",
"email": "olegp@example.com",
"phone_number": "",
"department": "Продукт",
"title": "CIO",
"role": "admin",
"suspended": false,
"invite_status": "confirmed",
"list_tags": [
"Product",
"Design"
],
"custom_properties": [
{
"id": 1678,
"name": "Город",
"data_type": "string",
"value": "Санкт-Петербург"
}
],
"user_status": null,
"bot": false,
"sso": false,
"created_at": "2020-06-08T09:32:57.000Z",
"last_activity_at": "2025-01-20T13:40:07.000Z",
"time_zone": "Europe/Moscow",
"image_url": null
}
}