Проекты

Проект — пространство для создания IoT-кейса, в котором находятся модели, объекты и другие сущности платформы. Проекты изолированы и не пересекаются между собой. Кроме того, проект — это удобный инструмент для совместного создания IoT-решения, т.к. вы можете пригласить в него других пользователей. Для разных участников команды проекта есть возможность задать индивидуальные роли, определяющие набор доступных возможностей.

При первом входе в платформу вы увидите единственный пустой проект с названием в формате Project of <логин>.

Кликните на название текущего проекта. Откроется список проектов: как ваших собственных, так и тех, в которые вас пригласили.

Подсказка: Отмечайте звездочками избранные проекты, с которыми вы работаете больше всего. Они переместятся наверх списка.

Создание проекта

Для создания нового проекта перейдите в меню управления проектами, нажав кнопку Управление проектами в списке проектов.

Добавьте проект, нажав на кнопку Создать. Заполните следующие поля:

  • имя — наименование проекта;
  • описание — подробная характеристика проекта, заполняется при необходимости.

При желании добавьте картинку-логотип для проекта.

Выберите тариф:

  • FREE — бесплатный тариф для знакомства с возможностями платформы и реализации простых кейсов. Можно создать только два бесплатных проекта. Когда этот лимит будет исчерпан, при создании нового проекта тариф FREE сменится на на тариф BASE.

Параметры проекта с бесплатной лицензией

Тип ограниченияЗначение
Количество моделей10
Количество объектов10
Количество автоматов10
Количество обработчиков10
Количество геозон10
Количество автоматов, добавленных на объект2
Количество обработчиков, добавленных на объект1
Количество геозон, добавленных на объект6
Количество токенов5
Размер пакета256 байт
Количество пакетов в сутки1440
Пропускная способность0,02 мегабит/сек
Итоговый размер хранилища10 мегабайт
  • BASE — платный тариф для небольшого проекта, настраивается в зависимости от выбранного количества объектов;
  • PRO — платный проект для масштабирования проекта с использованием большего числа сущностей, также настраивается в зависимости от выбранного количества объектов;
  • CUSTOM — платный проект с расширенной лицензией, настраиваемой индивидуально для каждого параметра.

Нажмите кнопку Сохранить. Перед вами откроется ваш новый проект. 

Smart home 

Project for my home devices

Удаление проекта

Вы можете удалять проекты, у которых нет оплаченного периода. Проект со всеми входящими в него сущностями удаляется безвозвратно.

Администрирование проекта

Перейдите на вкладку Администрирование проекта, чтобы управлять командой проекта, ролями и издавать API токены.

Команда

В разделе Команда вы можете пригласить других участников присоединиться к проекту.

Определите роль, с которой пользователь будет участвовать в проекте.

Выберите способ приглашения:

  • Пригласить по e-mail: В этом случае по указанным адресам придет письмо со ссылкой для принятия приглашения. Эта ссылка будет работать только для указанного в приглашении e-mail. Если у получателя письма еще нет аккаунта с данным адресом электронной почты, то он должен зарегистрироваться с ним  в платформе, после чего он сможет принять приглашение. Срок действия ссылки такого типа истекает через 24 часа.
  • Пригласить по ссылке: В этом случае генерируется универсальная ссылка, по которой любой пользователь, зарегистрированный в платформе, может присоединиться к проекту. Ссылки такого типа работают до тех пор, пока они не отозваны владельцем проекта и лимит пользователей проекта не исчерпан.

В таблице располагается список пользователей проекта, их роли и статус отправленных приглашений. Владелец проекта может исключать пользователей из проекта и изменять им роль.

Если ссылка истекла, вы можете выслать приглашение повторно. 

Роли

Для того чтобы приглашать пользователей, необходимо выбрать роль, с которой они присоединятся к проекту. По умолчанию доступна роль [rightech] signup с максимальными правами на управление сущностями, но можно создать другие роли с любым набором доступных методов. 

Перейдите в раздел Роли. Для создания новой роли нажмите кнопку Создать. Заполните имя и при необходимости выберите шаблон с готовым набором прав доступа. Затем выберите методы, доступные для новой роли.

Важно: Функции по управлению проектом (редактирование проекта, приглашение новых пользователей, оплата подписки и т.д.) доступны только владельцу проекта.

Нажмите кнопку Сохранить. Теперь данную роль вы можете использовать для приглашения новых пользователей в разделе Команда или сгенерировать универсальную ссылку для приглашения кнопкой Создать ссылку.

API токены

В разделе API токены вы можете издать токен для вашего проекта, чтобы использовать HTTP API платформы.

Нажмите кнопку Создать. Заполните имя и при необходимости измените срок действия токена. По умолчанию токен действителен месяц. Выберите те методы, которые планируете использовать при взаимодействии по API.

Важно: В целях безопасности при издании токена не рекомендуется включать Все методы. Выбирая только некоторые методы, вы сокращаете возможный урон, который можно нанести до тех пор, пока токен не будет отозван в случае его утечки.

Нажмите кнопку Издать. Отобразится сформированный токен. Сохраните его себе, так как после ухода с этой страницы получить токен будет невозможно. Также вы можете сразу отозвать токен, если он был создан ошибочно.

Токен необходимо указывать в каждом запросе в заголовке Authorization после слова Bearer в формате:

Authorization: Bearer <ACCESS TOKEN VALUE>

Для тестирования API можете воспользоваться HTTP-клиентом Postman, который позволяет отправлять различные запросы. На странице токена присутствует готовая коллекция запросов и переменные окружения, которые можно импортировать в интерфейс Postman. В этом случае самостоятельно указывать токен в запросах не нужно, он уже будет там присутствовать.

После обновления страницы возможность сохранить токен и скачать переменные окружения для Postman пропадает.