Проекты
Проект — пространство для создания 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 пропадает.
