Тема
Каталог инструментов
Каталог открытый: ни один инструмент не обязателен. Сервер реализует те семейства, данные для которых у бизнеса есть, и может добавлять собственные инструменты без префикса norm_.
| Инструмент | Семейство | Доступ | Назначение |
|---|---|---|---|
norm_meetings_list | Встречи | чтение | Встречи компании за интервал дат. |
norm_meeting_get | Встречи | чтение | Сводка одной встречи по id: резюме, поручения, темы, ключевые вопросы, участники и повестка — этого достаточно для протокола и задач. |
norm_meeting_transcript | Встречи | чтение | Сырая расшифровка встречи окном — дорогой вызов, берите только если сводки не хватило. |
norm_protocol_types | Протоколы встреч | чтение | Типы встреч компании и подсказки к ним — весь справочник одним ответом, спрашивайте один раз за прогон. |
norm_protocols_list | Протоколы встреч | чтение | Протоколы компании страницами, от свежих к старым по дате встречи. |
norm_protocol_get | Протоколы встреч | чтение | Протокол одной встречи по meeting_id целиком: ядро, тело, дополнительные поля, ссылка. |
norm_protocol_upsert | Протоколы встреч | запись | Создать или переписать протокол встречи: ядро полей плюс тело в markdown. |
norm_org_units | Люди и оргструктура | чтение | Дерево подразделений компании целиком. |
norm_people_list | Люди и оргструктура | чтение | Сотрудники компании страницами. |
norm_roles_list | Люди и оргструктура | чтение | Роли компании страницами: то, чем занимаются её люди. |
norm_person_get | Люди и оргструктура | чтение | Карточка одного сотрудника целиком. |
norm_person_upsert | Люди и оргструктура | запись | Создать или обновить карточку сотрудника. |
norm_notify | Уведомления | запись | Уведомить человека о том, что требует его внимания: о незаполненном, о неуверенно определённом, о готовности. |
В таблице «Данные ответа» у каждого инструмента колонка «При успехе» говорит, обязательно ли поле, когда в ответе нет data.error (подробнее — «Доменные состояния»).