Права на выполнение тех или иных методов REST API регулируются с помощью механизма скоупов (SCOPE). Когда вы добавляете тиражное решение в партнерском кабинете или локальное решение на своем конкретном Битрикс24, вы указываете перечень необходимых скоупов Битрикс24 для работы конкретного приложения.
Привязка к конкретному скоупу указывается в описании каждого метода REST в самом начале. Например,
Scope:
CRM
Кто может выполнять метод: любой пользователь
Обратите также внимание на пометку «Кто может выполнять метод». Часть методов может вызываться только от имени пользователя с административными правами на конкретном Битрикс24.
Рассмотрим конкретную ситуацию, когда ваше решение интегрирует Битрикс24 с внешней телефонией и вы пользуетесь методами telephony.externalcall.register
и telephony.externalcall.finish
, которые добавляют в том числе лиды в CRM, но при этом не обращаетесь явно к методам CRM вроде crm.lead.add
и crm.activity.add
. В этом случае вашему приложению потребуется скоуп telephony, а вот скоуп crm — нет.
#| || Код скоупа | Название скоупа| Инструмент Битрикс24|| || ai_admin | Канал для регистрации пользовательского сервиса для обработки запросов| Копилот || || bizproc | Бизнес-процессы | Бизнес-процессы, RPA, роботы CRM || || calendar | Календарь | Календарь || || call | Телефония (совершение звонков). В скоуп входят методы: voximplant.infocall.startwithsound, voximplant.infocall.startwithtext| Телефония || || cashbox | Кассы | Кассы || || catalog | Торговый каталог | Торговый каталог, складской учет || || crm | CRM | CRM || || documentgenerator, crm.documentgenerator | Генератор документов, Генератор документов CRM | Генератор документов || || delivery | Доставки | Интернет-магазин, CRM || || department | Структура компании | Структура компании || || disk | Диск | Битрикс24.Диск || || entity | Хранилище данных | Хранилище данных || || im | Чат и уведомления | Чат и уведомления || || imbot | Создание и управление Чат-ботами | Боты для чата || || imopenlines | Открытые линии | Открытые линии || || landing | Сайты | Сайты || || lists | Списки | Универсальные списки || || log | Живая лента | Лента новостей || || mailservice | Почтовые сервисы | Почтовые сервисы || || messageservice | Служба сообщений | Служба сообщений || || pay_system | Платежные системы | Платежные системы || || pull | Pull&Push | Pull&Push || || rpa | Роботизация бизнеса | Роботизация бизнеса || || sale | Интернет-магазин | Интернет-магазин || || sonet_group, socialnetwork | Рабочие группы соцсети | Рабочие группы соцсети || || task | Задачи | Задачи || || telephony | Телефония | Телефония || || timeman | Учет рабочего времени | Учет рабочего времени || || user | Пользователи Версии:
- user_brief — Пользователи (минимальный)
- user_basic — Пользователи (базовый) | Пользователи || || user.userfield | Пользовательские поля пользователя | Пользовательские поля || || userfieldconfig | Настройки пользовательских полей | Настройки пользовательских полей || || userconsent | Работа с соглашениями | Работа с соглашениями || |#
[*ключ_task]: Кроме этого, доступны еще три устаревших скоупа — tasks, tasks_extended, tasksmobile. Их не нужно использовать.