Skip to content

Семейство: 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"
        ]
      }
    ]
  }
}