# Ekipmanınızı bağlayın. Verilerini bakım hizmetlerine dönüştürün.

> Otomasyonu siz sağlarsınız ve müşteriyi siz tanırsınız. Wertek AI; varlıkları izlemek, gözlemleri kaydetmek, iş emirlerini yönetmek ve düzenli bir hizmet sunmak için platformu sağlar.

Entegratörler için · Wertek AI · https://wertek.ai/tr/integrators/

**Giriş:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **Çıkış hedefi:** SCADA / HMI · Proses veri arşivi

**Salt okunur: Wertek AI, PLC’nize yazmaz.**

## Protokolleriniz sisteme gelir. SCADA sisteminiz, salt okunur bir API anahtarıyla durumu okur.

Ne olduğunu, nasıl bağlandığını ve durumunu görmek için herhangi bir çizgiye tıklayın.

**Wertek AI:** Varlık · Durum · Uyarı · İş emri · Rapor

### Giriş

#### OT · Üretim sahası

- **[Wertek AI ağ geçidi](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP; 17 markadan 32 cihaz (Eastron, Schneider, Siemens, Circutor, ABB, Janitza, Carlo Gavazzi…) ve kondansatör bankları için yazmaç haritalarıyla. Ekipmanlar zaten bu şekilde raporluyor.
- **MQTT üzerinden yayımlayan cihazlar** *(Provizyonlama ile)* — Banner DXM (kablosuz titreşim, 4G modem ile), Acrel kitleri ve enerji sayaçları. Ekipmanlar zaten bu şekilde raporluyor.
- **Bir anahtarla HTTP üzerinden kendi akışınız** *(Node-RED / Ignition / ağ geçidi üzerinden)* — Node-RED, Ignition, n8n, Python veya JavaScript/TypeScript; Modbus TCP, MQTT ve OPC UA için simüle edilmiş değerlerle doğrulanmış tarifler.
- **Bently Nevada System 1 üzerinden OPC UA** *(Beta)* — Okuma bağlayıcısı.
- **[Sahada, telefonla](https://wertek.ai/tr/mobile/)** — Fotoğraflı gözlemler, VibeDiag ile video, akustik analiz ve manuel okumalar (saat, çevrim, kWh…).

> S7, EtherNet/IP ve genel OPC UA: kendi sürücümüz yok; bunlara Node-RED, Ignition veya bir ağ geçidi üzerinden ulaşırsınız.

#### IT · İş sistemleri

- **Bakım ve ERP** — Kendi iş emirlerini getirirler: SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **Dosyalar** — Uygulanmadan önce incelenen CSV veya Excel varlıkları; WAV, UFF58 ve CSV sinyalleri.

### Çıkış

#### OT · Üretim sahası

- **Tesis proses veri arşivleri** — Wertek AI, ölçümlerini ve varlık sağlığını proses veri arşivine, proses verilerinizin yanına yazar: AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **Okuma anahtarıyla SCADA, HMI veya Node-RED** — Ignition, Node-RED veya bir betik; durumu proses tag’lerinin yanında göstermek için varlıkları, sonuç ve önerileriyle birlikte ölçümleri ve enerjiyi okur. Okuma anahtarı Monitoring planından itibaren oluşturulur.

> Wertek AI, PLC'nize yazmaz: olguları ve durumları yayımlar; hangi tag'i değiştireceğinize siz karar verirsiniz.

#### IT · İş sistemleri

- **Anahtarlı API** — Varlıklar, ölçümler, sinyal ve FFT ile enerji; JSON biçiminde dışa aktarma. Okuma anahtarı Monitoring planından itibaren oluşturulur.
- **İndirmeler** — CSV, XLSX, Parquet, WAV ve PDF: ölçümler, gözlemler, iş emirleri, tüketim ve elektrik şebeke yönetmeliğine uygunluk raporu.
- **Uyarılar** — Anlık bildirim ve e-posta, ayrıca uygulamada canlı.
- **E-postayla periyodik raporlar** — Enerji ve elektrik şebeke yönetmeliğine uygunluk, durum ve tüketim merkezlerinin aylık özeti.
- **[Bakım ve ERP](https://wertek.ai/tr/integrations/)** — Her biri denetlenmiş durumuyla bağlayıcılar: MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## Anahtarlı HTTP: her cihaz için yol

1. **Ücretsiz hesabınızı oluşturun.** app.wertek.ai adresinde. Yalnızca veri alım izni olan bir anahtar her planda çalışır. [Hesap oluştur](https://app.wertek.ai/signup)
2. **Varlığı oluşturun ve ölçüm noktasını atayın.** Uygulamada varlığı kaydedin ve veri besleyeceğiniz konumu atayın: kodu, UCUM birimleriyle değişkenleri ve periyodu. Anahtarla da atayabilirsiniz: POST /iaes/assets/{asset_id}/measurement-points. Atama bir ölçüm noktası tüketir: her gönderimde değil, konum başına bir kez yapın.
3. **Veri alım anahtarını oluşturun.** Ayarlar → API Anahtarları (Settings → API Keys) bölümünde, veri alım izniyle. Gizli tutun: bir ortam değişkeninde, asla kodda veya etikette değil.
4. **Okumayı gönderin.** Okuma başına bir asset.measurement olayı, tek başına veya en fazla 100 öğelik listede, POST https://api.wertek.ai/iaes/ingest adresine gönderilir. Yanıt, olay başına bir kod içerir; kaydedilenler varlığın geçmişinde, atanmış konum altında görünür.

### Ölçüm noktası nasıl atanır

1. **Measurement points’te (veya varlıkta) «Designate position» düğmesine tıklayın.** Atama, kuruluşunuzun havuzundan bir ölçüm noktası kullanır: her gönderimde değil, konum başına bir kez yapılır.
2. **Kodu, şablonu ve periyodu doldurun.** Kod, entegrasyonunuzun göndereceği `location` değeridir (küçük harflerle, boşluksuz). Şablon, ailenin değişkenlerini UCUM birimleriyle getirir; özel değişkenler ekleyebilirsiniz. Sözleşmedeki periyot, saniye cinsinden ne sıklıkla okuma göndereceğinizi belirtir.

   ![«Designate a measurement position» iletişim kutusu: kod, şablon, değişkenler ve periyot](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **Konum listede görünür ve okumaları almaya başlar.** Bu kod ve veri alım anahtarıyla gönderdiğiniz her olay, varlığın geçmişinde o konum altında saklanır.

### Olay (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"
  }
}
```

Veri alımının kullandığı sürüm olan yayımlanmış IAES 2.0.2 SDK ile doğrulandı.

- `data.location` — atanmış konumun kodu
- `data.measurement_type` — değişkenin anahtarı
- `data.unit` — sözleşmenin birimi (karşılaştırılır, asla dönüştürülmez)
- `data.value` — bir sayı; boolean değerler 0 veya 1 olarak iletilir
- `timestamp` — UTC cinsinden ölçüm zamanı — gönderdiğiniz zaman değil
- `event_id` — her okuma için yeni; idempotans anahtarıdır

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

Tarifin akışını (pump-process-to-wertek.flow.json) içe aktarın; iaes-publish düğümü aynı anahtarı kullanır.

### Tarifler

- **Node-RED.** Yazılımda doğrulanmış tarif: kabul betiği, benzetilmiş değerlerle API üzerinde çalışır. IAES düğümleri 2.0.2, gerçek bir Node-RED 5.0.6 içine aktarılıp çalıştırıldı (Docker, 2026-11-12): 5/5 olay geçerli. [Tarif, akış ve kabul betiği](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** 2026-10-05 tarihinde API üzerinde doğrulanmış tarif; otomatik kabul betiği yoktur. IAES düğümleri 2.0.2, gerçek bir n8n 2.8.4 içine aktarılıp çalıştırıldı (2026-11-12): 5/5 olay geçerli. [Tarif ve iş akışı](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **Herhangi bir HTTP istemcisi.** Temel tarif: varlığın sözleşmesini okuyun, konumu atayın, gönderin ve yanıtı olay olay okuyun. [Tarif ve kabul betiği](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### Peki MQTT?

Bugün MQTT, belirli ekipmanlar için kanallar demektir — Banner DXM, Acrel kitleri ve enerji sayaçları — her biri kendi konusu ve kimlik bilgisiyle, provizyonlama ile kurulur. Evrensel bir konu yoktur: diğer tüm cihazlar için yol, anahtarlı HTTP'dir.

## Gelen verilerinizi ne korur ve neleri kontrol edersiniz

Kodun bugün yaptığı ve bunun ötesinde hiçbir şey.

- **Veri alım anahtarları.** Bir anahtar wk_ ile başlar ve oluşturulduğunda bir kez gösterilir. Wertek AI, onu tanımak için yalnızca SHA-256 özetini ve 12 karakterlik bir ön eki saklar.
- **İzinler, süre sonu ve iptal.** Her anahtar kendi izinlerini (telemetry.view, telemetry.export, iaes.ingest) taşır, belirli varlıklarla sınırlanabilir, 1 ile 365 gün arasında süresi dolabilir ve iptal edilebilir. Anahtarları yalnızca bir sahip veya yönetici yönetir.
- **Kuruluşunuza bağlı.** Bir olay yalnızca anahtarın kuruluşundaki varlıklar için kabul edilir: bir anahtar başka bir kuruluşun varlıklarına yazamaz.
- **Aktarım sırasında.** API, HTTPS üzerinden sunulur. MQTT için TLS ile 8883 portunu kullanın.
- **İmzalı bağlantılar üzerinden dosyalar.** Kayıtlar ve belgeler, HMAC-SHA256 ile imzalanmış ve süresi dolan bağlantılar üzerinden iletilir.
- **Saklanan veriler.** Sağlayıcılarımız (veritabanı için Supabase ve dosyalar için Cloudflare R2) sakladıkları verileri şifreler.
- **Sınırlar ve kullanım.** Makine kimlik bilgisi başına dakikada en fazla 300 istek (üzerinde 429) ve toplu gönderim başına 100 olay. Telemetri API'si her anahtarın kullanımını ve son kullanımını kaydeder.

### Entegratörler için öneriler

- MQTT: TLS ile 8883 portu.
- Şifrelenmemiş veri göndermeyi önermiyoruz. Bir cihaz TLS desteklemiyorsa bizimle görüşün: başka korumalarla değerlendirilebilir.
- Tesis başına, en az izinle (veri göndermek için iaes.ingest) ve süre sonuyla bir anahtar.
- Anahtarı bir ortam değişkeninde veya gizli bilgi deposunda tutun, asla kodda veya akışta tutmayın.
- Bir cihaz veya tesis ayrıldığında anahtarı iptal edin.

## Açık kaynak kodlarıyla yayımlanmış paketler

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. Yedi düğüm: measurement, health, work-order, validate, sparkplug, publish ve route. Yayımlanmış sürüm: 2.0.2 · [Kaynak kodu](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 için topluluk düğümü. Yayımlanmış sürüm: 2.0.2 · [Kaynak kodu](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`. İstemci, modeller ve olay doğrulaması (doğrulama ajv kullanır). Yayımlanmış sürüm: 2.0.2 · [Kaynak kodu](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"`. Modeller ve doğrulama: Wertek AI veri alımının kullandığı doğrulayıcının aynısı. Yayımlanmış sürüm: 2.0.2 · [Kaynak kodu](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**Ön izleme.** Arduino Opta: iaes-opta-runtime, IAES 1.4 üretir ve Wertek AI veri alımı 2.x ister. Bu bir ön izlemedir, üretim için değildir. [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES: Akışı bir kez oluşturun.** Her müşteride yeniden kullanılan tek bir açık olay formatı ve müşterinizin Wertek AI ile elde ettikleri. [Entegratörler için IAES'i inceleyin](https://wertek.ai/tr/integrators/iaes/index.md)

Standart: IAES 2.0, açık (CC BY 4.0). [iaes.dev](https://iaes.dev/) · [DOI 10.5281/zenodo.22663498](https://doi.org/10.5281/zenodo.22663498)

## Veri depolama alanından fazlası

- **Varlık ve geçmişi.** Her okuma, varlığın geçmişinde atadığınız konum altında kalır.
- **Gözlemler.** Müşterinizin ekibi sahada bulduklarını fotoğraflarla, web veya telefon üzerinden kaydeder.
- **İş emirleri.** Bulgulara göre işlem yapmak ve her müdahalenin kaydını tutmak için. Technical ve üzeri.
- **Mobil uygulama.** Android ve iPhone'da saha çalışmaları için.

## Verileri almak ücretsizdir; izlemek değildir.

Ödeme yaptığınız şey varlık değil, izlenen ölçüm noktasıdır.

- 1 ölçüm noktası: yılda USD 36
- 5 ölçüm noktası paketi: yılda USD 120

Bu sayfa yayımlandığında okunan güncel Wertek AI kataloğundaki fiyatlar. [Tüm planları gör](https://wertek.ai/pricing.html)

## Varlığı müşteriniz yönetir; size izin verdiğini görürsünüz

- Varlık ve geçmişi, onu yönetene aittir: müşterinize. Kaydettiklerinizde sizin yazarlığınız korunur.
- Müşterinizin izin verdiklerini görürsünüz: tesis, alan veya varlık bazında, zaman aralıklarıyla.
- Varsayılan olarak ölçüm noktalarının ücretini müşteriniz öder.
- Yollarınız ayrılırsa varlık ve teknik geçmişi müşterinizde kalır; erişiminiz iptal edildiğinde sona erer.

[Growth Program hakkında](https://wertek.ai/growth-program.html)

## Veri alımının kabul ettikleri

| | |
|---|---|
| Yol | POST https://api.wertek.ai/iaes/ingest |
| Üstbilgi | X-API-Key, iaes.ingest izniyle |
| Olay | IAES, spec_version 2.x |
| Toplu gönderim | istek başına en fazla 100 olay |
| Sınır | anahtar başına dakikada 300 istek |
| Periyot | sözleşmedeki periyodun 90 %'ı dolmadan gelen okuma atılır (kod 504) |
| Varlığın sözleşmesi | GET /iaes/assets/{asset_id}/measurement-points, anahtarla |
| Şema ve kodlar | GET /iaes/schema ve /iaes/schema/codes, anahtarla |
| Yanıt | olay başına bir kod: 1xx kaydedildi · 2xx uyarıyla kaydedildi · 4xx mesajı düzeltin · 5xx yeniden deneyin |

## Sık sorulan sorular

**Bir plana ihtiyacım var mı?** Veri göndermek için plana ihtiyacınız yoktur; izlenen her ölçüm noktası katalog üzerinden ücretlendirilir. Plan, birine ulaşan uyarıları, iş emirlerini ve daha uzun geçmişi etkinleştirir.

**Nerede çalışır?** Veri alımı bir Wertek AI bulut hizmetidir. Wertek AI ağ geçidi ise ağınızda çalışır: ekipmanı okur ve okumaları gönderir.

**Veri alımı PLC'me yazar mı?** Hayır. Veri alımı yalnızca veri alır.

**Periyottan daha hızlı gönderirsem ne olur?** Sözleşmedeki periyodun 90 %'ı dolmadan gelen okuma 504 koduyla atılır. Gönderimlerinizi ölçüm noktasının periyoduna uydurun.

