REST API: Список уровней доступа – scope
Материал из Planfix
Токены авторизации могут быть ограничены заданными уровнями доступа - scope. Поддерживаются следующие уровни доступа:
- Задачи
- task_readonly — доступно только получение списка задач или задачи по номеру, а также пунктов чек-листа и их списков.
- task_add — доступно только создание новых задач и пунктов чек-листа.
- task_update — доступно только изменение задач и пунктов чек-листа.
- task_delete — доступно только удаление задач и пунктов чек-листа.
- Сотрудники
- user_readonly — доступно только получение списка сотрудников или сотрудника по номеру, а также групп и должностей сотрудников.
- user_add — доступно только создание новых сотрудников.
- user_update — доступно только изменение сотрудников и преобразование сотрудника в контакт.
- user_delete — доступно только удаление сотрудников.
- Контакты
- contact_readonly — доступно только получение списка контактов и компаний или контакта/компании по номеру.
- contact_add — доступно только создание и импорт новых контактов и компаний.
- contact_update — доступно только изменение и восстановление контактов и компаний.
- contact_delete — доступно только удаление контактов и компаний.
- Комментарии
- comment_readonly — доступно только получение списка комментариев или комментария по номеру.
- comment_add — доступно только создание новых комментариев.
- comment_update — доступно только изменение комментариев.
- comment_delete — доступно только удаление комментариев.
- Аналитики
- datatag_readonly — доступно только получение списка аналитик, записей аналитик или аналитики по номеру.
- datatag_add — доступно только добавление новых записей аналитик.
- datatag_update — доступно только изменение записей аналитик.
- datatag_delete — доступно только удаление записей аналитик.
- Файлы
- file_readonly — доступно только получение метаданных файла, скачивание файла по номеру и получение списков файлов задач, контактов и проектов.
- file_add — доступны только загрузка файлов, в том числе по URL, изменение метаданных файлов и прикрепление файлов к задачам, контактам и проектам.
- file_delete — доступно только удаление файлов.
- Пользовательские и общие поля
- common_metadata — доступно получение существующих пользовательских и общих полей, их типов и метаданных, а также наборов пользовательских полей.
- custom_field_add — доступны только создание и изменение пользовательских полей задач, контактов, проектов, сотрудников и общих полей.
- custom_field_set_add — доступно только создание наборов пользовательских полей задач, контактов, проектов и сотрудников.
- custom_field_delete — доступно только удаление пользовательских полей задач, контактов, проектов, сотрудников и общих полей.
- Проекты
- project_readonly — доступно только получение списка проектов или проекта по номеру, а также шаблонов и групп проектов.
- project_add — доступно только создание новых проектов.
- project_update — доступно только изменение проектов.
- project_delete — доступно только удаление проектов.
- Справочники
- directory_readonly — доступно только получение списка справочников, их групп и записей, справочника или записи по номеру, а также фильтрация записей.
- directory_add — доступно только создание новых справочников и добавление записей справочников.
- directory_update — доступно только изменение справочников и их записей.
- directory_delete — доступно только удаление записей справочников.
- Процессы
- process_readonly — доступно только получение процессов задач и контактов, а также статусов процессов задач.
- Отчеты
- report_readonly — доступно получение списка отчетов или отчета по номеру, сохраненных версий и их данных, а также запуск формирования отчета и проверка его готовности.
- report_delete — доступно только удаление отчетов и сохраненных версий отчетов.
- Объекты
- object_readonly — доступно только получение списка объектов, объекта по номеру и статусов объекта.
- object_delete — доступно только удаление объектов.
- Настройки системы
- system_settings — доступны создание, изменение и удаление должностей сотрудников, а также получение служебных настроек, предусмотренных методами API.