Как использовать API атрибутов машины
Создайте Tulip Machine с использованием данных из Node-RED, Python или других сервисов.
Advanced Article - assumes previous experience with REST APIs.Click here to view our Machines API documentation.
Резюме
API атрибутов машины позволяет отправлять данные в конкретный атрибут машины через RESTful API с использованием конечной точки /attributes/report. Это открывает множество гибких возможностей для интеграции с Tulip из Node-RED, Python или других языков и сервисов.
Настройка API Machine
Prior to r383, Service Accounts were called "API Tokens".
Примечание: Если у вас уже настроен API таблиц Tulip, вы можете использовать тот же ключ и секретный ключ API.
- Перейдите в «Настройки» > «Tulip API»
- Нажмите «Создать служебную учетную запись » в правом верхнем углу экрана
- Укажите имя служебной учетной записи и выберите
«attributes:report»в качестве области действия:

- Появится модальное окно с вашим ключом API, секретным ключом и заголовком аутентификации. Сохраните эту информацию, так как повторно получить к ней доступ будет невозможно!
Настройка нового станка
После настройки API станка в вашем экземпляре появится новый источник данных станка. Чтобы просмотреть этот источник данных, перейдите в раздел «Производство» > «Станки» и перейдите к «Источникам данных станков»:

Вам необходимо создать новое оборудование, связанное с этим источником данных. Чтобы создать новое оборудование, перейдите в раздел «Библиотека оборудования» и нажмите «Создать оборудование».
Появится следующее модальное окно:

- Название станка (обязательно): Назовите свой станок
- Источник данных машины (обязательно): выберите Tulip API
- Станция (необязательно)
- Тип (обязательно): если тип отсутствует, сначала создайте его; в данном примере созданный тип называется «default»
Теперь, когда ваше устройство создано, вам нужно добавить атрибут. Нажмите «Редактировать» в правом верхнем углу экрана. Затем нажмите кнопку «+» в правом верхнем углу экрана:

Поскольку атрибуты машины еще не созданы, нажмите на название типа машины, выделенное синим цветом (в данном случае — «Default»).
Вы перейдете на страницу типа машины, связанного с данной машиной. Нажмите кнопку «Редактировать» в правом верхнем углу экрана.
Затем нажмите кнопку «+» рядом с пунктом «Атрибуты машины» в левом нижнем углу.
Теперь нажмите «+ Создать атрибут машины » в правом нижнем углу
В данном примере мы создадим атрибут «Счётчик » типа «Целое число».

После создания атрибута выберите атрибут «Счётчик» в списке «Атрибуты машины», а затем нажмите кнопку «Сохранить» в правом верхнем углу.
Вернитесь на страницу вашего устройства.
Теперь, когда атрибут машины создан, вы можете добавить его к своей машине. Нажмите кнопку «Редактировать» в правом верхнем углу. Затем нажмите кнопку «+» в правом верхнем углу и выберите только что созданный атрибут «Счётчик »:

Нажмите «Сохранить » в правом верхнем углу.
Теперь ваш экземпляр Tulip настроен с использованием Machine API, машины и атрибута машины — теперь вы можете отправлять данные в машину Tulip из любого места!
Здесь вы можете увидеть attributeId и machineID для атрибута «Counter ». Эту информацию можно скопировать, нажав на значок, и она будет использоваться в теле HTTP-запроса.
Для этого вам необходимо быть знакомым с REST-API. Полную документацию по использованию конечной точки /attributes/report, включая параметры запроса и формат тела, можно найти по адресу your-company.tulip.co/apidocs или перейдя по ссылке на странице API Tulip...

... а в документации есть раздел, посвящённый мониторингу машин

Дополнительная информация
Ознакомьтесь с этой статьёй, если хотите углубить свои знания об API и узнать, как его можно использовать с Edge MC и Node-RED!
