Veri Köprüsü (Data Bridge)

Agent'lar

Veri Köprüsü (Data Bridge), tag değerlerini kuzey yönünde dış sistemlere köprüler. Ayrı Windows servisi (MergenHubDataBridge) olarak çalışır; çekirdek REST'ten beslenir (X-MergenHub-Token). Her şey bir agent'tır — varsayılan açık hiçbir şey yoktur, REST Server dahil.

REST Server	Gelen bağlantı: dış sistem `/iotgateway/browse\|read\|write` uçlarından tag okur/yazar (endüstriyel standart JSON `{id,s,r,v,q,t}`). Kapalıysa uç 404'tür.
MQTT Client	Giden: seçili tag'leri bir broker'a publish eder (`[{id,v,q,t}]`); write-topic ile çift yönlü. Saha portu açmadan bulut entegrasyonu.
REST Client	Giden: tag değerlerini bir REST uca gönderir (POST/PUT/PATCH; Basic / Bearer / API-Key kimlik doğrulama; periyot ya da değişince). Test isteği gönder ile kaydetmeden denenebilir.

Yayın tetiği: periyot (publishRateMs) veya yalnız değişince (publishOnChangeOnly). Bağlantı durumu (bağlı/yayınlanan/son hata) her agent'ın Durum sekmesinde canlı izlenir.

Not API route'ları (/iotgateway), iç exe adı ve ayar anahtarları teknik uyumluluk için IoT Gateway kimliğini korur; Windows servis adı MergenHubDataBridge, ürün adı ise Veri Köprüsü / Data Bridge'dir.

Ayrıca bkzAgent Örnekleri

Agent Örnekleri & Uçlar

REST Server — okuma/yazma

# Değer oku (id = tag yolu)
GET /iotgateway/read?ids=Modbus_1.1001.Debi
→ [{"id":"Modbus_1.1001.Debi","v":42.5,"q":true,"t":1712345678}]

# Değer yaz
POST /iotgateway/write
[{"id":"Modbus_1.1001.Setpoint","v":50}]

MQTT Client agent (yapılandırma)

{
  "name": "Broker1", "type": "MqttClient", "enabled": true,
  "brokerHost": "10.0.0.20", "brokerPort": 1883,
  "topic": "saha/veri", "qos": 1,
  "publishRateMs": 1000, "publishOnChangeOnly": true,
  "tags": ["Modbus_1.1001.Debi", "Modbus_1.1001.Basinc"],
  "writeTopic": "saha/yaz"
}

REST Client agent — gönderilen zarf & kimlik doğrulama

PATCH https://sunucu.example.com/api/veri
Content-Type: application/json
X-API-Key: ********        ← Auth: API Key (başlık adı seçilebilir)

{"timestamp": 1723094400000,
 "values": [
   {"id":"Kanal.Cihaz.Debi","v":42.5,"q":true,"t":1723094399870}
 ]}

Kimlik doğrulama türleri: Basic (kullanıcı+parola), Bearer (token), API Key (özel başlık) — başlığı elle yazmak gerekmez; ek başlıklar ayrıca satır satır girilebilir. Formdaki "Nasıl çalışır? + örnek" bölümü, girdiğiniz değerlerle eşdeğer curl komutunu üretir.

İpucu Test isteği gönder, ayarları KAYDETMEDEN gerçek zarfla hedefe tek istek atar; HTTP durum kodu, süre ve yanıt gövdesi ekranda görünür — entegrasyonu dakikalar içinde doğrularsınız.

Not Yayın payload'ı [{"id","v","q","t"}] biçimindedir. writeTopic boşsa yazma kapalıdır. TLS için 8883 portu + CA/istemci sertifikası.