GraphQL
Второй транспорт платформы: один запрос вместо серии, подписки на события. Используется мобильными клиентами.
Точка входа
POST https://api.kommand.ru/graphql
Интерактивная консоль и дамп схемы доступны администраторам аккаунта. Состав операций — ниже, он собирается из самой схемы.
Мутации
acknowledgeInboxItem
«Ознакомлен»: подтверждение пишется в журнал действий, элемент закрывается.
adminAssignTask
Назначить ответственного за задачу (admin only).
adminDisableUserLogin
Запретить вход пользователю (admin only).
adminInviteUser
Пригласить пользователя в активный аккаунт (admin only). Новому человеку уходит письмо об установке пароля; сотрудник организации получает доступ к аккаунту.
archiveInboxItem
Убрать элемент «к сведению» в архив. «Требует действия» без выполнения не убирается.
completeTask
Перевести задачу в финальный статус с кодом `done`.
declineInboxItem
«Не могу выполнить»: отказ с причиной пишется в журнал, автору уходит обращение.
markInboxItemSeen
Отметить элемент увиденным (открыл карточку).
snoozeInboxItem
«Напомнить позже»: элемент скрыт до времени (у «требует действия» — не позже срока).
updateProfile
Обновить профиль текущего пользователя.
Запросы
account
Активный аккаунт для контекста запроса.
customFieldDefinitions
Метаданные своих полей раздела — тот же контракт, что у REST-эндпоинта describe.
documents
Документы аккаунта с фильтрами.
folders
Папки аккаунта.
inboxCounter
Сколько элементов «Входящих» ждут действия (счётчик раздела).
inboxItems
«Входящие» текущего пользователя в активном аккаунте (Ф23).
node
Relay node: поиск по глобальному ID.
section
Кастомный раздел по ключу.
sectionRecords
Записи кастомного раздела по имени, в правах роли.
sections
Кастомные разделы организации, готовые к работе.
tasks
Задачи текущего пользователя в активном аккаунте.
viewer
Текущий аутентифицированный пользователь.
Подписки
inboxItemReceived
Поток новых элементов «Входящих» текущего пользователя.