REST API doğrulanmış veriyi ve kontrolü otomasyona taşır.
Smart Kablo, uyumlu PDU veya UPS çıkışına bağlı cihazın elektrik ölçümlerini izleme altyapısına açar. Belgelenmiş REST API; canlı veri, geçmiş tüketim ve yetkili röle işlemlerini uygulama akışlarına alır. SNMP entegrasyonu ise kurulu sürümde gerekli MIB/OID nesneleri doğrulandıktan sonra NMS veya DCIM katmanına bağlanmalıdır.
SNMP ile REST API arasındaki fark
SNMP, çok sayıda cihazın NMS veya DCIM üzerinden düzenli aralıklarla sorgulandığı izleme mimarilerine uygundur. JSON döndüren REST API ise cihaz bilgisi, anlık elektrik ölçümleri, saatlik ya da aylık tüketim geçmişi ve kimliği doğrulanmış uzaktan güç kontrolü için uygulamalara daha esnek bir entegrasyon katmanı sunar. İki yöntem aynı projede birbirini tamamlayabilir.
| Yöntem | Güçlü olduğu alan | Örnek kullanım |
|---|---|---|
| SNMP | NMS/DCIM sorguları ve MIB/OID tabanlı izleme | Kurulu modelde doğrulanan nesnelerin periyodik okunması |
| REST API | JSON veri alışverişi, raporlama ve otomasyon | Canlı telemetri, tüketim geçmişi ve yetkili röle komutu |
Enerji verisi ve uzaktan güç kontrolü arayüzde nasıl görünür?
Entegrasyona taşınan değerlerin aynı cihaz üzerinde anlamlı bir bağlamı vardır: gerilim, akım, aktif güç, güç faktörü ve kWh tüketimi birlikte değerlendirilir; saatlik eğilimler incelenir ve röle durumu hedef cihazla eşleştirilir. Aşağıdaki gerçek Smart Kablo mobil uygulama ekranları bu veri akışının kullanıcı tarafındaki karşılığını gösterir.
REST API ile canlı telemetri, saatlik geçmiş ve aylık kWh
Smart Kablo REST API, ölçüm verisini yalnızca ekranda göstermekle
kalmaz; uygulama, raporlama ve otomasyon sistemlerinin okuyabileceği
JSON yanıtları sunar. Aşağıdaki gerçek Postman ekranları
/api/v1/telemetry, /api/v1/history ve
/api/v1/consumption uç noktalarının cihaz üzerindeki
karşılığını gösterir.
GET /api/v1/telemetry ile gerilim, akım, aktif güç,
görünür güç, güç faktörü, frekans ve cihaz zaman bilgileri JSON
olarak alınır.
GET /api/v1/history yanıtındaki saat başlangıcı,
ortalama akım, gerilim, watt, frekans ve enerji kWh alanları
trend ve alarm analizinde kullanılabilir.
GET /api/v1/consumption çağrısı ayın ilk
gününden bugüne günlük energy_kwh noktalarını ve
toplamı döndürür. Özel tarih aralığı desteği kurulu firmware'de
ayrıca doğrulanmalıdır. Ölçümü aylık maliyete çevirmek için
sunucu elektrik tüketimi hesaplayıcısını kullanabilirsiniz.
REST API kullanıcı kılavuzu ve hızlı başlangıç
Teknik kılavuz; Basic Auth ile bağlantıdan cihaz bilgisi ve canlı telemetri sorgularına, röle açma-kapatma işlemlerinden aylık tüketim ve saatlik geçmiş verisine kadar doğrulanmış örnek akışları içerir. Üretime geçmeden önce cihaz modeli, firmware sürümü ve erişim politikanızla uyumluluğu kontrol edin.
Postman ekranları ve istek/yanıt örnekleriyle entegrasyonu adım adım inceleyin veya kurulum ve röle kullanımının kısa özetini açın.
Veri modeli nasıl kurulmalı?
Her Smart Kablo için benzersiz cihaz kimliği, bağlı ekipman adı, rack/kabin konumu, giriş tipi ve sorumlu ekip kayıt altına alınmalıdır. Ölçüm verisi zaman damgası ve birimiyle saklanmalı; watt, volt, amper ve hertz değerleri birbirine karıştırılmamalıdır. UID fonksiyonu dijital kimlikle fiziksel kabloyu eşleştirmek için kullanılabilir.
Anlamlı alarm eşikleri
Tek bir sabit güç eşiği tüm cihazlar için uygun değildir. Normal çalışma, boşta çalışma ve kapalı durum için temel profil çıkarılmalıdır. Beklenmeyen sıfır güç, cihazın kapanması veya bağlantı kaybı anlamına gelebilir; normalden yüksek güç ise yük artışı ya da arıza incelemesi gerektirebilir. SNMP sorgu aralığı, alarm gecikmesi ve tekrar sayısı kısa süreli geçişlerin yanlış alarm üretmesini önleyecek biçimde cihaz profiline göre ayarlanmalıdır.
Röle API'sinde güvenlik sınırları
Okuma yetkisi ile enerji kesme yetkisi ayrılmalıdır. API erişimi kimlik doğrulama, ağ segmentasyonu, güçlü ve cihaza özel parola ile olay kaydıyla korunmalıdır. Kritik röle komutunda cihaz kimliği, hedef bağlantı ve bakım penceresi yeniden doğrulanmalı; başarılı yanıt alındıktan sonra röle ve ölçüm durumu yeniden okunmalıdır. Otomasyonun başarısız olması durumunda güvenli geri dönüş akışı tanımlanmalıdır.
Akıllı PDU izleme yaklaşımını cihaz bazında uygulama
Smart Kablo, uyumlu standart PDU veya UPS çıkışı ile seçilen cihaz arasına eklenir. Böylece tüm rack PDU'yu değiştirmeden sunucu, switch, NAS veya ATX PC gibi kritik bağlantılarda cihaz bazlı enerji izleme ve uzaktan güç kontrolü kademeli olarak devreye alınabilir. Mimari farkları önce akıllı PDU nedir karşılaştırmasından inceleyebilirsiniz. Fiziksel bağlantıyı C14, C20, Schuko ve projeye göre NEMA seçeneklerini birlikte gösteren Smart Kablo ürün grubu bağlantı seçeneklerinden belirleyebilirsiniz; merkezi veri modeli ise ortak kalır.
SNMP ve REST API hakkında sık sorulanlar
SNMP ve REST API birlikte kullanılabilir mi?
Evet. Kurulu model ve firmware için gereken SNMP sürümü ile MIB/OID kapsamı doğrulandığında SNMP, NMS veya DCIM izleme katmanında; belgelenmiş REST API ise canlı ölçüm, tüketim geçmişi ve yetkili röle işlemlerinin uygulama ya da otomasyon akışlarında birlikte kullanılabilir.
REST API ile uzaktan güç kontrolü yapılabilir mi?
Smart Kablo REST API kullanıcı kılavuzu röleyi açma, kapatma ve süreli yeniden açma akışlarını içerir. Yazma yetkisi sınırlandırılmalı; hedef cihaz, bakım penceresi ve komut sonucu doğrulanmalıdır.
Smart Kablo akıllı PDU izleme yerine nasıl konumlanır?
Smart Kablo, uyumlu standart PDU veya UPS çıkışı ile seçilen cihaz arasına eklenerek cihaz bazında ölçüm ve röle kontrolü sağlar. Tüm PDU'yu değiştirmez; ihtiyaç duyulan bağlantılarda akıllı PDU izleme yaklaşımının kademeli uygulanmasına yardımcı olur.
Enerji izleme entegrasyonunda hangi veriler kullanılabilir?
Gerilim, akım, aktif güç, frekans, güç faktörü, kWh tüketimi, röle durumu ve saatlik ya da aylık geçmiş verileri izleme ve raporlama akışlarında kullanılabilir.