Yeni: Yapay zekâ güvenlik duvarı tüm platformu izliyor ve her olayı sade bir dille açıklıyor. Nasıl çalıştığını görün

Geliştiriciler

MQTT ve HTTPS cihaz API'leri, kapsamlı anahtarlarla REST API, imzalı webhook'lar, hız sınırları ve yapay zekâ asistanları için MCP sunucuları.

Geliştiriciler

Hermetry ile geliştirin

Cihazları MQTT veya HTTPS üzerinden bağlayın, REST API ile kuruluşunuzla çalışın, imzalı webhook'larla olaylara tepki verin ve yapay zekâ asistanlarının MCP üzerinden verilerinizi okumasına izin verin.

Dört giriş yolu

Tek platform, dört arayüz

Cihazlar cihaz API’sini kullanır. Sistemleriniz REST API’yi ve webhook’ları kullanır. Yapay zekâ asistanları MCP’yi kullanır. Bir cihaza asla API anahtarı, bir entegrasyona ise asla cihaz belirteci koymayın.

Cihaz API’si

Cihazlar verileri MQTT veya HTTPS üzerinden gönderir ve komutları bu yollarla alır. Cihaz belirteci, MQTT kullanıcı adı ve parolası ya da sertifika ile oturum açarlar.

REST API

ERP, MES, bilet sisteminiz ya da betiğiniz, yalnızca sizin seçtiğiniz izinlere sahip bir API anahtarıyla Hermetry’yi çağırır.

Webhook’lar

Bir şey olduğunda Hermetry sisteminizi çağırır: bir cihazın çevrimdışı olması, bir alarmın açılması ya da bir komutun tamamlanması gibi.

MCP sunucuları

MCP’yi destekleyen bir yapay zekâ asistanı, Hermetry’nin araçlarını bir API anahtarı ya da oturum açma ile çağırır ve hiçbir zaman o kişinin yapabileceğinden fazlasını yapamaz.

Cihaz API’si

İlk okumanızı gönderin

MQTT üzerinden cihaz tek bir bağlantıyı açık tutar. HTTPS üzerinden ise her mesaj için bir istek gönderir. Yükler aynıdır.

MQTT

  • MQTT 3.1.1, 8883 numaralı bağlantı noktasında TLS (TLS 1.2 veya üzeri), cihazın Bağlantı ayrıntıları kartındaki ana bilgisayara
  • Kullanıcı adı: cihaz erişim belirteci, parola boş
  • Konular v1/ ile başlar; QoS 1 kullanın
  • Okuma, düz bir JSON nesnesidir; cihaz zamanı biliyorsa ts ve values kullanılır
CONNECT   port 8883 (TLS)
          username: <device access token>, password: empty
SUBSCRIBE v1/attributes/set   (QoS 1)
SUBSCRIBE v1/attributes/res/+ (QoS 1)
SUBSCRIBE v1/rpc/req/+        (QoS 1)
PUBLISH   v1/attributes/req/1 {}
PUBLISH   v1/telemetry        {"temperature": 21.5, "humidity": 40}
{"temperature": 21.5, "humidity": 40, "door_open": false}

{"ts": 1759572000000, "values": {"temperature": 21.5, "humidity": 40}}

HTTPS

  • Mesaj başına bir POST, belirteç Authorization: Bearer başlığında
  • MQTT ile aynı yük biçimleri ve anahtar kuralları, 64 KiB’a kadar
  • Komutlar en fazla 60 saniyelik bir uzun sorguda bekler
  • Uyanan, veri gönderen ve uyuyan pil ile çalışan cihazlar için en uygun seçenek
curl -X POST 'https://<your-host>/api/v1/telemetry' \
  -H 'Authorization: Bearer <device access token>' \
  -H 'Content-Type: application/json' \
  -d '{"ts":1759572000000,"values":{"temperature":21.5,"humidity":40}}'
curl -X GET 'https://<your-host>/api/v1/rpc?timeout=20000' \
  -H 'Authorization: Bearer <device access token>'

REST API

API’yi kapsamlı bir anahtarla çağırın

Bir API anahtarı, onu oluşturan üye adına hareket eder ve yalnızca bu anahtar için işaretlediğiniz izinlerle sınırlıdır. Belirteç değişimi yoktur: anahtar her çağrıda gönderilir.

  • Anahtarlar sk_live_… biçiminde görünür ve yalnızca bir kez gösterilir
  • İzinler her seferinde bir modül seçilerek belirlenir ve asla kendi yetkinizden fazla olamaz
  • Her anahtarın bir son kullanma tarihi vardır: varsayılan 90 gün, en fazla bir yıl
  • En fazla 100 alt ağı içeren bir IP izin listesi, anahtarın nerede çalışacağını sınırlar
  • Yollar kuruluşunuzun altındadır: /tenant/<tenantId>/api/…
curl "https://<your host>/tenant/<tenantId>/api/iot/devices" \
  -H "Authorization: Bearer sk_live_…"
GET /tenant/{tenantId}/api/telemetry/latest?kind=iot_device&entityId={deviceId}&keys=temperature,humidity

Webhook’lar

Olaylara tepki verin ve bunların bizden geldiğini doğrulayın

Her teslimat, gövdesinde olayın bulunduğu ve başlıklarında bir imza bulunan bir POST isteğidir. Gövdeye güvenmeden önce X-Webhook-Signature-V2 değerini imzalama sırrınızla doğrulayın.

  • Yalnızca HTTPS adresleri, en fazla 20 özel başlık ile
  • Olay filtreleri yalnızca yükü eşleşen olayları teslim eder
  • Her yeniden denemede aynı X-Webhook-Delivery kimliği gönderilir, böylece yinelenenleri ayıklayabilirsiniz
  • Tercih ederseniz, varsayılan zarf yerine CloudEvents 1.0 kullanılabilir
{
  "webhookId": "…",
  "tenantId": "…",
  "event": "device.disconnected",
  "createdAt": "2026-11-03T12:00:30.000Z",
  "data": { "deviceId": "…", "name": "router-17", "reason": "timeout" }
}
import crypto from 'crypto';

function verifyWebhook(body: string, timestamp: string, signatureV2: string, secret: string): boolean {
  const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(`${timestamp}.${body}`).digest('hex');
  // Reject deliveries older than 5 minutes.
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
  const a = Buffer.from(expected);
  const b = Buffer.from(signatureV2);
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

Sınırlar

Planlanması gereken sınırlar

Bir sınır, Retry-After başlığıyla 429 yanıtı verir. Bu süre kadar bekleyin, tekrarlarda geri çekilin ve bir 400, 401, 403, 404 ya da 422 yanıtını hiçbir zaman değiştirmeden yeniden denemeyin.

SınırVarsayılanGeçerli olduğu yer
Adres sınırıDakikada 120 istekHer çağıran IP adresi
Anahtar sınırıDakikada 1.000 çağrıHer API anahtarı
KomutlarCihaz başına dakikada 10, kuruluş başına dakikada 600Cihazlara gönderilen komutlar
MCP araçlarıDakikada 120 okuma ve 20 yazma çağrısıHer kimlik bilgisi
Cihaz HTTP gövdesi64 KiB’a kadarHer cihaz mesajı

Yapay zekâ asistanları

Bir yapay zekâ asistanını MCP üzerinden bağlayın

Her modülün, çalışma alanınızın adresi altında kendi MCP sunucusu vardır. Bir yönetici açana kadar MCP kapalıdır ve bir asistan yalnızca ilgili kişinin kullanabileceği araçları görür.

  • Cihazlar, okumalar ve panolar: yalnızca okuma
  • Alarmlar: biri hemen onaylanır; birinin temizlenmesi ikinci bir kişiyi bekler
  • Yanıtlar 10 saniye ve 256 KiB ile sınırlıdır
  • Cihaz kimlik bilgileri, belirteçler ve anahtarlar asla geri döndürülmez
https://<your host>/tenant/<tenantId>/api/mcp/iot_device
https://<your host>/tenant/<tenantId>/api/mcp/telemetry
https://<your host>/tenant/<tenantId>/api/mcp/iot_alarm
https://<your host>/tenant/<tenantId>/api/mcp/dashboard

Ölçeklendirin ve genişletin

Tek bir cihaz bin cihaza dönüştüğünde

CSV’den içe aktarma

Bir dosyadan yüzlerce cihaz ekleyin. Her içe aktarma önce kontrol edilir, incelemeden sonra uygulanır ve geri alınabilir.

Kod ile talep etme ve sağlama

Cihazlar bir kodla talep edilir ya da bir sağlama oturumu aracılığıyla ilk bağlantıda kaydedilir.

Dalgalar halinde imzalı firmware

Görüntüleri kendi boru hattınızda imzalarsınız ve yalnızca genel anahtarları kaydedersiniz. Dağıtımlar dalgalar halinde yapılır.

Kendi codec’leriniz

Kitaplığın kapsamadığı bir LoRaWAN sensörünü, yayımladığınız bir codec ile çözün: bir betik değil, bir JSON tablosu.

Betik bloğu

Bir akışın hazır blokları yetersiz kaldığında, her mesaj üzerinde kendi JavaScript kodunuzu çalıştırın.

Kendi widget’larınız

Yapılandırılmış bir kartı widget olarak kaydedin ya da kendi ayar formuna sahip, bir HTML şablonundan widget’lar oluşturun.

Hermetry üzerinde geliştirmeye başlayın

Bir kuruluş oluşturun, bir cihaz ekleyin ve ilk API çağrınızı yapın.