Geliştiriciler · Açık platform

Platformun etrafında değil, üzerine inşa edin.

HERO, API'nin tek istemcisi değil, bir istemcisidir. Filo durumunu ve geçmişini okuyun, olaylara abone olun ve makinelere yazılımı uzaktan gönderin — kiracı bazında yetkilendirilmiş, belgelenmiş bir REST API üzerinden. Ekibiniz HTTP çağırabiliyorsa, DMS üzerine geliştirebilir.

API erişimi isteyin Platformu görün
REST + JSON Webhook'lar Kiracı bazlı yetki

Entegrasyon felsefesi

Her iki uçtan açık

Platform, girişi olan kapalı bir kutu değildir. Operatörlerinizin HERO'da gördüğü aynı veri API üzerinden erişilebilir; yazılımımızı dağıtan aynı OTA hattı sizinkini de taşıyabilir. Bağımlılık için değil, entegrasyon için tasarlıyoruz.

  • Tek doğru kaynak

    Cihazlar, işlemler ve telemetri QuadC'de yaşar; API, HERO'nun okuyup yazdığı aynı kayıtları okur ve yazar — dışa aktarma gecikmesi yok, ikinci kopya yok.

  • Kiracı bazında yetkilendirilmiş

    Her çağrı bir kiracı anahtarıyla filonuza kapsanır. Kendi makinelerinizi görürsünüz, başkasınınkini değil.

  • Dürüst, sürümlenmiş yüzey

    Belgelediğimiz ve sürümlediğimiz kararlı bir REST sözleşmesi — altınızdan değişen özel bir uç nokta değil.

REST API

Yüzey, dürüstçe anlatıldı

API'nin bugün sunduklarının bir özeti. Tam referans, istek ve yanıt şemaları ve bir sandbox anahtarı erişimle birlikte gelir — isteyin, sizi hazırlayalım.

TEMEL https://api.dms-tech.com/v1
  • GET /devices Filonuzdaki makineleri durum, model ve son görülme ile listeler.
  • GET /devices/{id} Tek makine: yapılandırma, sağlık ve anlık çevrimiçi durum.
  • GET /transactions Makine, yöntem ve tarihe göre filtrelenebilir satış ve ödeme kayıtları.
  • GET /telemetry Makine bazında tipli telemetri olayları — stok, sıcaklık, arıza, çalışma süresi.
  • POST /devices/{id}/commands Makineye komut gönderin: etkinleştir, devre dışı bırak, yeniden yapılandır, fiyatla.
  • POST /webhooks Olayları gerçekleştikçe almak için bir uç nokta kaydedin.

Yanıtlar JSON'dır; sayfalama ve filtreleme sorgu parametreleridir; hatalar makine tarafından okunabilir bir kod ve insanca bir mesaj taşır.

Webhook'lar

Olayı bekleyin, sormayın

Bir kez abone olun; platform olayları gerçekleştikçe uç noktanıza gönderir — böylece sistemleriniz API'yi yormadan bir satışa ya da arızaya saniyeler içinde tepki verir.

transaction.completed Bir makinede ödeme gerçekleşti — tutar, yöntem, makine ve saat.
machine.fault Bir makine arıza verdi — kod, makine ve önem — tetiklendiği an.
stock.low Bir slot düşük stok eşiğini geçti ve dolum gerektiriyor.
machine.offline Bir makine ağdan düştü ya da yeniden çevrimiçi oldu.

OTA hattı

Sahaya yazılımı bir API çağrısıyla gönderin

Hero Nexus sürümlerini dağıtan uzaktan güncelleme hattı betiklenebilir. Bir sürümü gruba açın, izleyin, genişletin ve geri alın — HERO'dan ya da API üzerinden kendi araçlarınızdan.

  • Gruba göre hedefleyin

    Tek makineye, bir sahaya, bir bölgeye ya da tüm filoya yayınlayın — kohortu siz seçin.

  • Kademeli ve izlenebilir

    Bir sürüm yayılırken benimsenmeyi ve sağlığı izleyin; hat, makine bazında ilerlemeyi raporlar.

  • Geri alınabilir

    Sürüm hata yaparsa kohortu saha ziyareti olmadan önceki sürüme geri alın.

Entegrasyon yolları

İki giriş yolu

İster makine üretin ister onları bağlayın, tanımlı bir yol var. Hangisi olduğunuzu söyleyin, sizi doğru yüzeye yönlendirelim.

OEM'ler ve makine üreticileri Kutudan bağlı çıkan makineler üretin. Hero Nexus seçtiğiniz terminalde çalışır; makinenizin kontrol arayüzünü bir kez eşleriz.
  1. Desteklenen bir terminal seçin
  2. Makineyi MDB / Executive / Modbus üzerinden eşleyin
  3. Buluta bağlı sevk edin
Sistem entegratörleri Filo verisini operatörün zaten kullandığı sistemlere katın — ERP, muhasebe, BI — REST API ve webhook'larla.
  1. Kiracı sandbox anahtarı alın
  2. Cihaz, işlem, telemetri çekin
  3. Canlı olaylar için webhook'lara abone olun

Sandbox anahtarı alın

Ne inşa ettiğinizi ve kim olduğunuzu anlatın — OEM, entegratör ya da geliştirici ekibi olan bir operatör. API belgelerini gönderelim ve bir sandbox kiracısı kuralım.

API erişimi isteyin QuadC'yi keşfedin