四つのステップで接続
キー付き HTTP:あらゆるデバイスの接続経路
- 1
無料アカウントを作成
app.wertek.ai で作成します。取り込み権限のみのキーは、どのプランでも使用できます。
アカウントを作成
- 2
アセットを作成し、測定点を指定
アプリでアセットを登録し、データを送る位置を指定します。コード、UCUM 単位付きの変数、周期を設定します。キーでも指定できます:POST /iaes/assets/{asset_id}/measurement-points。指定には測定点を一つ消費します。送信のたびではなく、位置ごとに一度だけ行ってください。
- 3
取り込みキーを作成
設定 → API キー (Settings → API Keys) で、取り込み権限を付けて作成します。秘密として管理してください。コードやタグではなく、環境変数に保存します。
- 4
測定値を送信
測定値ごとに一つの asset.measurement イベントを、単独または最大 100 件のリストで POST https://api.wertek.ai/iaes/ingest に送信します。応答にはイベントごとに一つのコードが含まれます。保存されたデータは、アセット履歴の指定した位置に表示されます。
測定点を指定する方法
1Measurement points(またはアセット)で «Designate position» をクリック。
もっと見る
指定すると、組織のプールから測定点を一つ消費します。送信のたびではなく、位置ごとに一度だけ行います。
2コード、テンプレート、周期を入力します。
1
2
3
- コード = location
- テンプレートと変数
- 周期
もっと見る
コードは連携から送信する `location` です(小文字、スペースなし)。テンプレートには、そのファミリーの変数と UCUM 単位が含まれます。独自の変数も追加できます。契約周期は秒単位で、測定値を送信する間隔を表します。
3位置が一覧に表示され、測定値の受信が始まります。
もっと見る
そのコードと取り込みキーで送信した各イベントは、アセットの履歴内の該当位置に保存されます。
イベント · reading.json
{
"spec_version": "2.0",
"event_id": "6f1c2b7e-3d4a-4e8b-9a10-5c2d7e9f1a34",
"correlation_id": "0b8e4c21-7f3a-4d6e-8c95-1a2b3c4d5e6f",
"event_type": "asset.measurement",
"timestamp": "2026-11-11T14:32:00Z",
"source": "plant_x.plc_12",
"dataschema": "https://iaes.dev/schema/v2/asset.measurement",
"asset": {
"asset_id": "PUMP-07"
},
"data": {
"measurement_type": "temperature",
"value": 23.5,
"unit": "Cel",
"location": "zona_1"
}
}
取り込みサービスが使用するバージョンである、公開済みの IAES 2.0.2 SDK で検証済みです。
data.location — 指定した位置のコード
data.measurement_type — 変数のキー
data.unit — 契約の単位(比較のみで、変換はしません)
data.value — 数値。ブール値は 0 または 1 として送信
timestamp — 測定時刻、UTC 基準 — 送信時刻ではありません
event_id — 測定値ごとに新しい値。冪等性キーです
curl
curl -X POST https://api.wertek.ai/iaes/ingest \
-H "X-API-Key: $WERTEK_API_KEY" \
-H "Content-Type: application/json" \
-d @reading.json
Python
# pip install requests (the validator: pip install "iaes[validate]==2.0.2")
import json, os, uuid
from datetime import datetime, timezone
import requests
event = json.load(open("reading.json"))
event["event_id"] = str(uuid.uuid4()) # new for each reading
event["correlation_id"] = str(uuid.uuid4()) # one per batch
event["timestamp"] = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ") # when it was measured
r = requests.post(
"https://api.wertek.ai/iaes/ingest",
json=[event],
headers={"X-API-Key": os.environ["WERTEK_API_KEY"]},
timeout=30,
)
print(r.status_code, r.json())
Node-RED
cd ~/.node-red
npm install [email protected]
構成手順のフロー (pump-process-to-wertek.flow.json) をインポートします。iaes-publish ノードは同じキーを使用します。
構成手順
Node-RED
ソフトウェアで検証した構成手順です。受け入れスクリプトは模擬値を使って API に対して実行されます。IAES ノード 2.0.2 を実際の Node-RED 5.0.6 にインポートして実行(Docker、2026-11-12):5/5 イベントが有効。
構成手順、フロー、受け入れスクリプト
n8n
2026-10-05 に API に対して確認した構成手順です。自動受け入れスクリプトはありません。IAES ノード 2.0.2 を実際の n8n 2.8.4 にインポートして実行(2026-11-12):5/5 イベントが有効。
構成手順とワークフロー
任意の HTTP クライアント
基本の構成手順です。アセットの契約を読み取り、位置を指定し、送信してイベントごとの応答を読み取ります。
構成手順と受け入れスクリプト
MQTT は?
現在の MQTT は特定機器用のチャネルです — Banner DXM、Acrel キット、電力量計 — それぞれ専用のトピックと認証情報を持ち、プロビジョニングで設定します。汎用トピックはありません。他の機器はキーを使った HTTP が経路となります。