四步完成连接
带密钥的 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。响应为每个事件提供一个代码;已存储的数据会显示在资产历史记录的指定位置下。
如何指定测点
1在 Measurement 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 接入。