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
tsvevalueskullanı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: Bearerbaş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-Deliverykimliğ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ır | Varsayılan | Geçerli olduğu yer |
|---|---|---|
| Adres sınırı | Dakikada 120 istek | Her çağıran IP adresi |
| Anahtar sınırı | Dakikada 1.000 çağrı | Her API anahtarı |
| Komutlar | Cihaz başına dakikada 10, kuruluş başına dakikada 600 | Cihazlara gönderilen komutlar |
| MCP araçları | Dakikada 120 okuma ve 20 yazma çağrısı | Her kimlik bilgisi |
| Cihaz HTTP gövdesi | 64 KiB’a kadar | Her 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.
Başvuru
API başvurusu
Hermetry üzerinde geliştirmeye başlayın
Bir kuruluş oluşturun, bir cihaz ekleyin ve ilk API çağrınızı yapın.

