如何使用机器属性 API

如何使用机器属性 API

使用来自 Node-RED、Python 或其他服务的数据创建郁金香机器。

:::(Info) (注）高级文章--假定已有 REST API 经验。点击此处查看我们的机器 API 文档：

摘要

机器属性 API 允许您使用/attributes/report端点通过 RESTful API 向机器的特定属性发送数据。这样就有了从 Node-RED、Python 或其他语言和服务与 Tulip 集成的多种灵活选择。

设置机器 API

注：如果您已经设置了Tulip 表 API，则可以使用该 API 密钥和秘钥

1. 导航至**"设置">"API 令牌**
2. 单击屏幕右上角的 "创建 API 令牌
3. 为 API 令牌命名，并为其范围选择**属性：写入**：

1. 一个包含API 密钥、密文和Auth Header的模式会出现。请保存这些信息，因为它们无法再次访问！

恭喜--您已正式设置了机器 API！

设置新机器

设置好机器 API 后，您的实例中将出现一个新的机器数据源。要查看该数据源，请单击 "车间 ">"机器"，然后导航到 "机器数据源"：

您需要创建一个与该数据源链接的新机器。要创建新机器，请导航至机器库，然后单击创建机器。

将出现以下模态：

1. 机器名称（必填）：机器名称（必填
2. 机器数据源（必填）：选择Tulip API
3. 站（可选）
4. 类型（必填）：如果没有可用类型，请先创建一个类型，本例中创建的类型名为default

机器已创建，您需要添加一个属性。点击屏幕右上角的编辑。然后点击屏幕右上方的**+**按钮：

由于尚未创建任何机器属性，请点击蓝色的 "机器类型"，本例中为 "默认"。

这将带您进入与机器相关联的机器类型。按屏幕右上角的编辑按钮。

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

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

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

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

返回机器页面。

机器属性创建完成后，您可以将其添加到机器中。按右上角的编辑按钮。然后点击右上角的**+按钮，选择您刚刚创建的计数器**属性：

请点击右上角的保存。

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

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

为此，您需要熟悉 REST API。关于如何使用/attributes/report端点的完整文档，包括查询参数和正文格式，可在your-company.tulip.co/apidocs或API 标记页面的链接中找到*.*..

......在文档中有一个机器监控部分

更多阅读

如果您想进一步了解 API，并了解如何将其与 Edge MC 和 Node-RED 结合使用，请查看这篇文章！