Machine Attributes API の使用方法
Node-RED、Python、またはその他のサービスからのデータを使用して、Tulip Machineを作成します。
Advanced Article - assumes previous experience with REST APIs.Click here to view our Machines API documentation.
概要
Machine Attributes API を使用すると、/attributes/reportエンドポイントを利用した RESTful API を通じて、マシンの特定の属性にデータを送信できます。これにより、Node-RED、Python、またはその他の言語やサービスから Tulip と統合するための柔軟な選択肢が数多く提供されます。
Machine API の設定
Prior to r383, Service Accounts were called "API Tokens".
注:すでにTulip Table APIを設定済みの場合は、そのAPIキーとシークレットを使用できます。
- [設定] > [Tulip API] に移動します
- 画面右上の [サービスアカウントの作成] をクリックします
- サービスアカウントに名前を付け、スコープとして
**attributes:report**を選択します:

- APIキー、シークレット、認証ヘッダーが表示されたモーダルウィンドウが表示されます。これらの情報は再度確認できないため、必ず保存してください!
新しいマシンの設定
マシンAPIの設定が完了すると、インスタンス上に新しい「マシンデータソース」が表示されます。このデータソースを表示するには、「Shop Floor」>「Machines」をクリックし、「Machine Data Sources」に移動してください**:**

このデータソースにリンクする新しいマシンを作成する必要があります。新しいマシンを作成するには、「Machine Library」に移動し、「Create Machine」をクリックしてください**。**
次のモーダルが表示されます:

- マシン名(必須):マシンに名前を付けます
- マシンデータソース(必須):Tulip APIを選択してください
- ステーション(任意)
- タイプ(必須):利用可能なタイプがない場合は、まずタイプを作成してください。この例では、作成されたタイプは「default」という名前です
マシンの作成が完了しましたので、属性を追加する必要があります。画面右上の「編集」をクリックしてください。次に、画面右上の**「+」**ボタンをクリックします:

まだマシン属性が作成されていないため、青色の「マシンタイプ」をクリックします。この場合は「Default」です。
これにより、そのマシンに関連付けられたマシンタイプ画面に移動します。画面右上の「編集」ボタンをクリックしてください。
次に、画面左下の「マシン属性」の横にある「+」ボタンをクリックします。
次に、画面右下にある***「+ マシン属性を作成***」をクリックします。
この例では、整数型の「カウンター」属性を作成します。

属性の作成が完了したら、「マシン属性」のリストから「カウンター属性」をクリックし、画面右上の「保存」をクリックしてください。
マシンページに戻ります。
マシン属性が作成されたので、これをマシンに追加できます。右上隅の*[編集]ボタンをクリックします。次に、右上隅の*[+]ボタンをクリックし、先ほど作成した「Counter」**属性を選択します:

右上の「保存」をクリックしてください。
これで、TulipインスタンスにMachine API、マシン、およびマシン属性が設定されました。これで、どこからでもTulipマシンにデータを送信できるようになりました!
ここから、Counter属性のattributeId とmachineIDを確認できます。この情報はアイコンをクリックしてコピーでき、HTTPリクエストの本文で使用されます。
これを行うには、REST API の知識が必要です。クエリパラメータやボディ形式を含め、/attributes/reportエンドポイントの使用方法に関する完全なドキュメントは、your-company.tulip.co/apidocsまたはTulip APIページのリンクから確認できます...

... また、ドキュメントには「マシンモニタリング」に関するセクションがあります

さらに詳しく
APIをさらに活用し、Edge MCやNode-REDとの連携方法を知りたい場合は、こちらの記事をご覧ください!
