# 连接您的设备。将设备数据转化为维护服务。

> 您提供自动化技术并了解客户。Wertek AI 提供平台，用于监视资产、记录观察结果、管理工单和提供持续性服务。

面向集成商 · Wertek AI · https://wertek.ai/zh/integrators/

**输入:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **输出至:** SCADA / HMI · 历史数据库

**只读：Wertek AI 不向您的 PLC 写入。**

## 接入您的协议。您的 SCADA 使用只读 API 密钥读取状态。

点击任意连线，查看它是什么、如何连接及其状态。

**Wertek AI:** 资产 · 状态 · 告警 · 工单 · 报告

### 输入

#### OT · 生产现场

- **[Wertek AI 网关](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP，提供 17 个品牌的 32 种设备（Eastron、Schneider、Siemens、Circutor、ABB、Janitza、Carlo Gavazzi…）及电容器组的寄存器映射。 设备已在通过这种方式上报。
- **通过 MQTT 发布的设备** *(含预配)* — Banner DXM（无线振动，配备 4G 调制解调器）、Acrel 套件和电能表。 设备已在通过这种方式上报。
- **使用密钥的自有 HTTP 流程** *(通过 Node-RED / Ignition / 网关)* — Node-RED、Ignition、n8n、Python 或 JavaScript/TypeScript；Modbus TCP、MQTT 和 OPC UA 配方，已用模拟值验证。
- **来自 Bently Nevada System 1 的 OPC UA** *(Beta)* — 读取连接器。
- **[在现场使用手机](https://wertek.ai/zh/mobile/)** — 附照片的观察记录、使用 VibeDiag 的视频、声学分析和手动读数（小时、周期、kWh…）。

> S7、EtherNet/IP 和通用 OPC UA：没有自有驱动；通过 Node-RED、Ignition 或网关访问。

#### IT · 业务系统

- **维护与 ERP** — 导入其工单： SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **文件** — 来自 CSV 或 Excel 的资产，应用前经过审核；WAV、UFF58 和 CSV 信号。

### 输出

#### OT · 生产现场

- **工厂历史数据库** — Wertek AI 将自身的测量值和资产健康状态写入历史数据库，与您的过程数据并列： AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **使用读取密钥的 SCADA、HMI 或 Node-RED** — Ignition、Node-RED 或脚本读取资产、含结果和建议的测量值以及能源，在过程 tag 旁显示状态。从 Monitoring 套餐起可创建读取密钥。

> Wertek AI 不向您的 PLC 写入：它发布事实和状态，由您决定修改哪个 tag。

#### IT · 业务系统

- **使用密钥的 API** — 资产、测量值、信号和 FFT，以及能源；以 JSON 导出。从 Monitoring 套餐起可创建读取密钥。
- **下载** — CSV、XLSX、Parquet、WAV 和 PDF：测量值、观察记录、工单、消耗量及电网规范合规报告。
- **告警** — 推送和电子邮件，以及应用内实时显示。
- **定期邮件报告** — 能源与电网规范合规、状态，以及消耗中心月度汇总。
- **[维护与 ERP](https://wertek.ai/zh/integrations/)** — 连接器，各自附有经审核的状态： MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## 带密钥的 HTTP：适用于任何设备的路径

1. **创建免费账户.** 在 app.wertek.ai 创建。仅具有接入权限的密钥适用于任何套餐。 [创建账户](https://app.wertek.ai/signup)
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. **填写代码、模板和采集周期。** 代码是集成将发送的 `location`（小写，无空格）。模板包含该系列的变量及其 UCUM 单位；你可以添加自定义变量。约定的采集周期以秒为单位，表示发送读数的频率。

   ![«Designate a measurement position» 对话框：代码、模板、变量和采集周期](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **位置显示在列表中，并开始接收读数。** 使用该代码和接入密钥发送的每个事件都会保存在资产历史中的该位置下。

### 事件 (reading.json)

```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

```bash
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

```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

```bash
cd ~/.node-red
npm install node-red-contrib-iaes@2.0.2
```

导入配置方案中的流程 (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 个事件有效。 [配置方案、流程和验收脚本](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** 已于 2026-10-05 对 API 验证的配置方案，无自动验收脚本。IAES 节点 2.0.2 已导入真实的 n8n 2.8.4 并运行（2026-11-12）：5/5 个事件有效。 [配置方案和工作流](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **任何 HTTP 客户端.** 基础配置方案：读取资产契约，指定位置，发送并逐个事件读取响应。 [配置方案和验收脚本](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### MQTT 呢？

目前 MQTT 指特定设备的通道 — Banner DXM、Acrel 套件和电能表 — 每个通道都有独立的主题和凭证，通过预配设置。没有通用主题：其他任何设备都通过带密钥的 HTTP 接入。

## 数据传入时由什么保护，以及你能控制什么

代码目前所做的事，仅此而已。

- **数据接入密钥.** 密钥以 wk_ 开头，仅在创建时显示一次。Wertek AI 只保存其 SHA-256 哈希值和12个字符的前缀，以便识别。
- **权限、到期与撤销.** 每个密钥都有其权限 (telemetry.view, telemetry.export, iaes.ingest)，可以限制为仅用于特定资产，可以设置在1至365天内到期，也可以撤销。只有所有者或管理员可以管理密钥。
- **绑定到你的组织.** 只有属于密钥所在组织的资产才会接受事件：密钥无法向其他组织的资产写入数据。
- **传输中.** API 通过 HTTPS 提供。对于 MQTT，请使用端口8883并启用 TLS。
- **通过签名链接提供文件.** 采集记录和文档通过使用 HMAC-SHA256 签名且会到期的链接交付。
- **存储的数据.** 我们的服务提供商（数据库使用 Supabase，文件使用 Cloudflare R2）会加密其存储的数据。
- **限制与使用情况.** 每个机器凭据每分钟最多300个请求（超出则返回429），每批次100个事件。遥测 API 记录每个密钥的使用情况及最后一次使用。

### 给集成商的建议

- MQTT：端口8883，使用 TLS。
- 我们不建议发送未加密的数据。如果设备不支持 TLS，请联系我们：可以结合其他保护措施进行评估。
- 每个站点使用一个密钥，设置最小权限（发送数据使用 iaes.ingest）和到期时间。
- 将密钥保存在环境变量或机密存储中，切勿放在代码或流程中。
- 设备或站点退出使用时，撤销密钥。

## 已发布的软件包，附开放源代码

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. 七个节点：measurement、health、work-order、validate、sparkplug、publish 和 route。 已发布版本: 2.0.2 · [源代码](https://github.com/wertek-ai/iaes/tree/nodered-v2.0.2/node-red) · [npm](https://www.npmjs.com/package/node-red-contrib-iaes)
- **n8n** — `npm install n8n-nodes-iaes@2.0.2`. 适用于 n8n 的社区节点。 已发布版本: 2.0.2 · [源代码](https://github.com/wertek-ai/iaes/tree/n8n-v2.0.2/n8n-nodes) · [npm](https://www.npmjs.com/package/n8n-nodes-iaes)
- **JavaScript / TypeScript** — `npm install @iaes/sdk@2.0.2`. 客户端、模型和事件验证（验证使用 ajv）。 已发布版本: 2.0.2 · [源代码](https://github.com/wertek-ai/iaes/tree/sdk-v2.0.2/npm) · [npm](https://www.npmjs.com/package/@iaes/sdk)
- **Python** — `pip install "iaes[validate]==2.0.2"`. 模型和验证：与 Wertek AI 接入服务使用的验证器相同。 已发布版本: 2.0.2 · [源代码](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**预览.** Arduino Opta：iaes-opta-runtime 输出 IAES 1.4，而 Wertek AI 接入服务要求 2.x。这是预览版本，不适用于生产环境。 [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES：一次构建流程.** 一种在每位客户处均可复用的开放事件格式，以及您的客户在 Wertek AI 中获得的交付功能。 [查看面向集成商的 IAES](https://wertek.ai/zh/integrators/iaes/index.md)

标准：IAES 2.0，开放 (CC BY 4.0)。 [iaes.dev](https://iaes.dev/) · [DOI 10.5281/zenodo.22663498](https://doi.org/10.5281/zenodo.22663498)

## 不只是数据存储空间

- **资产及其历史记录.** 每个读数都会保留在资产历史记录中，位于您指定的位置下。
- **观察记录.** 客户团队通过网页或手机记录现场发现的情况，并附上照片。
- **工单.** 根据发现的情况采取行动，并保留每次干预的记录。从 Technical 套餐起提供。
- **移动应用.** 用于现场工作，支持 Android 和 iPhone。

## 接收数据免费；监视数据收费。

您付费的是被监视的测点，而不是资产。

- 1 个测点：每年 USD 36
- 5 个测点包：每年 USD 120

价格来自本页发布时查阅的现行 Wertek AI 价目表。 [查看所有套餐](https://wertek.ai/pricing.html)

## 您的客户管理资产；您只能查看客户授权的内容

- 资产及其历史记录属于管理该资产的人，也就是您的客户。您记录的内容保留您的作者身份。
- 您可以按工厂、区域或资产，在指定时间窗口内查看客户授权的内容。
- 默认由您的客户支付测点费用。
- 如果双方结束合作，资产及其技术历史记录仍归客户保留；您的访问权限在被撤销时终止。

[关于 Growth Program](https://wertek.ai/growth-program.html)

## 接入服务接受什么

| | |
|---|---|
| 路由 | POST https://api.wertek.ai/iaes/ingest |
| 请求头 | X-API-Key，具有 iaes.ingest 权限 |
| 事件 | IAES, spec_version 2.x |
| 批次 | 每个请求最多 100 个事件 |
| 限制 | 每个密钥每分钟 300 个请求 |
| 周期 | 在约定周期的 90 % 之前到达的读数将被丢弃（代码 504） |
| 资产契约 | GET /iaes/assets/{asset_id}/measurement-points，使用密钥 |
| 模式和代码 | GET /iaes/schema 和 /iaes/schema/codes，使用密钥 |
| 响应 | 每个事件一个代码：1xx 已存储 · 2xx 已存储但有警告 · 4xx 修正消息 · 5xx 重试 |

## 常见问题

**我需要套餐吗？** 发送数据不需要套餐；每个被监视的测点按价目表收费。套餐启用可送达相关人员的警报、工单和更长的历史记录。

**在哪里运行？** 接入服务是 Wertek AI 云服务。Wertek AI 网关则在您的网络中运行：读取设备并推送读数。

**接入服务会写入我的 PLC 吗？** 不会。接入服务只接收数据。

**如果发送速度快于规定周期会怎样？** 在约定周期的 90 % 之前到达的读数将被丢弃，代码为 504。请按测点周期发送。

