如何使用机器属性API

如何使用机器属性API

使用来自Node-RED、Python或其他服务的数据创建一个Tulip机器。

摘要

机器属性API允许你通过RESTful API使用/attributes/report端点向机器的一个特定属性发送数据。这使得许多灵活的选项可以从Node-RED、Python或其他语言和服务中与Tulip集成。

设置机器API

注意：如果你已经设置了一个Tulip表API，你可以使用该API密钥和密文

1. 导航到你的设置 > 机器人
2. 在屏幕的右上角点击创建机器人
3. 命名你的机器人，并为它的范围选择**属性：写**。

1. 一个包含你的API Key、Secret和Auth Header的模式将会出现。请保存这些信息，因为它不能被再次访问。

恭喜你--你已经正式设置了你的Machine API!

设置一个新的机器

一旦你设置了你的机器API，一个新的机器数据源将出现在你的实例上。要查看这个数据源，请点击车间>机器，并导航到机器数据源。

你必须创建一个新的机器，链接到这个数据源。要创建一个新的机器，请导航到机器库，并点击创建机器。

将会出现以下模式。

1. 机器名称（必填）。你的机器的名称
2. 机器数据源（必填）。选择Tulip API
3. 站台(可选)
4. 类型(需要):如果没有可用的类型，先创建一个类型，在这个例子中，创建的类型被命名为default。

现在你的机器已经创建，你需要添加一个属性。点击屏幕右上方的 "编辑"。然后点击屏幕右上方的 "+"按钮。

由于还没有创建机器属性，所以按蓝色的机器类型，在本例中是默认。

这将带你到与机器相关的机器类型。按屏幕右上角的 "编辑"按钮。

然后按左下角机器属性旁边的+按钮。

现在在右下角按***+创建机器属性***

在这个例子中，我们将创建一个整数类型的计数器属性。

一旦你的属性创建完成，点击机器属性列表中的计数器属性，然后按右上角的保存。

继续回到你的机器页面。

现在你的机器属性已经创建，你可以把它添加到你的机器上。按右上角的 "编辑"按钮。然后点击右上角的 "+"按钮，选择你刚刚创建的 "计数器"属性。

请点击右上角的保存。

你的郁金香实例现在已经设置了机器API、机器和机器属性--现在你可以从任何地方向郁金香机器发送数据了!

从这里你可以看到计数器属性的attributeId和machineID。这个信息可以通过点击图标复制，并将在http请求的正文中使用。

要做到这一点，你将需要熟悉REST APIs。关于如何使用/attributes/report端点的完整文档，包括查询参数和正文格式，可以在your-company.tulip.co/apidocs找到，或者通过点击Bots页面上的链接...

...在文档中，有一个关于机器监控的部分

进一步阅读

如果你想进一步了解API，看看它如何与Edge MC和Node-RED一起使用，请查看这篇文章