- 打印
如何使用机器属性API
使用来自Node-RED、Python或其他服务的数据创建一个Tulip机器。
高级文章 - 假设以前有REST API的经验
摘要
机器属性API允许你通过RESTful API使用/attributes/report
端点向机器的一个特定属性发送数据。这使得许多灵活的选项可以从Node-RED、Python或其他语言和服务中与Tulip集成。
设置机器API
注意:如果你已经设置了一个Tulip表API,你可以使用该API密钥和密文
- 导航到你的设置 > 机器人
- 在屏幕的右上角点击创建机器人
- 命名你的机器人,并为它的范围选择**
属性:写
**。
- 一个包含你的API Key、Secret和Auth Header的模式将会出现。请保存这些信息,因为它不能被再次访问。
恭喜你--你已经正式设置了你的Machine API!
设置一个新的机器
一旦你设置了你的机器API,一个新的机器数据源将出现在你的实例上。要查看这个数据源,请点击车间>机器,并导航到机器数据源。
你必须创建一个新的机器,链接到这个数据源。要创建一个新的机器,请导航到机器库,并点击创建机器。
将会出现以下模式。
- 机器名称(必填)。你的机器的名称
- 机器数据源(必填)。选择Tulip API
- 站台(可选)
- 类型(需要):如果没有可用的类型,先创建一个类型,在这个例子中,创建的类型被命名为default。
现在你的机器已经创建,你需要添加一个属性。点击屏幕右上方的 "编辑"。然后点击屏幕右上方的 "+"按钮。
由于还没有创建机器属性,所以按蓝色的机器类型,在本例中是默认。
这将带你到与机器相关的机器类型。按屏幕右上角的 "编辑"按钮。
然后按左下角机器属性旁边的+按钮。
现在在右下角按***+创建机器属性***
在这个例子中,我们将创建一个整数类型的计数器属性。
一旦你的属性创建完成,点击机器属性列表中的计数器属性,然后按右上角的保存。
继续回到你的机器页面。
现在你的机器属性已经创建,你可以把它添加到你的机器上。按右上角的 "编辑"按钮。然后点击右上角的 "+"按钮,选择你刚刚创建的 "计数器"属性。
请点击右上角的保存。
你的郁金香实例现在已经设置了机器API、机器和机器属性--现在你可以从任何地方向郁金香机器发送数据了!
从这里你可以看到计数器属性的attributeId
和machineID
。这个信息可以通过点击图标复制,并将在http请求的正文中使用。
要做到这一点,你将需要熟悉REST APIs。关于如何使用/attributes/report
端点的完整文档,包括查询参数和正文格式,可以在your-company.tulip.co/apidocs找到,或者通过点击Bots页面上的链接...
...在文档中,有一个关于机器监控的部分
进一步阅读
如果你想进一步了解API,看看它如何与Edge MC和Node-RED一起使用,请查看这篇文章