Метод для получения информации о сотруднике.
Для получения сотрудника вам необходимо знать его 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) | |
created_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,
"created_at": "2020-06-08T09:32:57.000Z",
"time_zone": "Europe/Moscow",
"image_url": null
}
}