Тема
Семейство: people
norm_org_units
Дерево подразделений компании целиком. Состав подразделения — сигнал, по которому подразделение встречи определяется без модели: если большинство участников числится в одном подразделении, выбор сделан. Членство прямое, принадлежность верхним уровням выводится по полю parent_id.
Доступ: чтение · Списковый: нет · Версии: 1
Вход
| Поле | Обязательно | Тип | Значение |
|---|
Данные ответа
| Поле | При успехе | Тип | Значение |
|---|---|---|---|
units | да | список OrgUnit |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "org:units",
"label": "Подразделения"
}
],
"freshness": {
"as_of": "2026-09-21T03:00:00.000Z",
"ttl_sec": 86400,
"stale": false
},
"data": {
"units": [
{
"id": "u-root",
"name": "Компания",
"parent_id": null
},
{
"id": "u-sales",
"name": "Продажи",
"parent_id": "u-root"
},
{
"id": "u-retail",
"name": "Розница",
"parent_id": "u-sales"
}
]
}
}norm_people_list
Сотрудники компании страницами. Поле id — то значение, которое возвращается в поля записи типа «человек». Почты приходят в нижнем регистре, и у одного человека их бывает несколько: сопоставляйте по любой из них. Для следующей страницы передайте page.next_cursor как cursor; нет курсора — люди дочитаны. total — сколько людей всего.
Доступ: чтение · Списковый: да · Версии: 1
Вход
| Поле | Обязательно | Тип | Значение |
|---|---|---|---|
cursor | нет | string | |
limit | нет | integer |
Данные ответа
| Поле | При успехе | Тип | Значение |
|---|---|---|---|
people | да | список Person | |
total | да | integer |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "org:people",
"label": "Сотрудники"
}
],
"freshness": {
"as_of": "2026-09-21T03:00:00.000Z",
"ttl_sec": 86400,
"stale": false
},
"page": {
"has_more": false
},
"data": {
"total": 2,
"people": [
{
"id": "p-1042",
"name": "Анна Новикова",
"aliases": [
"Новикова А.",
"a.novikova"
],
"emails": [
"a.novikova@example.com",
"79001234567@example.com"
],
"unit_ids": [
"u-sales"
]
},
{
"id": "p-1077",
"name": "Михаил Петров",
"aliases": [
"Петров М."
],
"emails": [
"m.petrov@example.com"
],
"unit_ids": [
"u-retail"
]
}
]
}
}