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

Uzaktan erişim API’si

Program üzerinden, talep edilmiş lisanslı yönlendiricilere ait panel oturumlarını açın, yeniden girin, kapatın ve listeleyin; her red ve sınırla birlikte.

Bu sayfa, bir yönlendiricinin web panelini kendi araçlarından açan entegratörler içindir; örneğin bir teknisyeni doğrudan müşterinin yönlendiricisinin paneline gönderen bir destek konsolu. Panel oturumlarının insanlar için nasıl işlediği Bir yönlendiricinin paneline uzaktan erişim sayfasında; sınırlar ve bir oturumun sona erme nedenleri ise Uzaktan erişim sınırları ve denetim sayfasındadır.

Yollar https://<your host>/tenant/<tenantId> altındadır. Kurallar REST API temelleri sayfasında yer alır.

Rotalar

YöntemYolİzinİşlevi
GET/api/iot/devices/{deviceId}/remote-accessiot_remote_access.panel.openBu yönlendiricide bir oturumun açılıp açılamayacağı ve açık oturumları
POST/api/iot/remote-access/sessionsiot_remote_access.panel.openBir panel oturumu aç
POST/api/iot/remote-access/sessions/{sessionId}iot_remote_access.panel.openOturumu açanın için yeni bir giriş bağlantısı
DELETE/api/iot/remote-access/sessions/{sessionId}iot_remote_access.panel.openBir oturumu kapat
GET/api/iot/remote-access/sessionsiot_remote_access.sessions.readKuruluşun oturumları ve bu ayki kullanım

Her iki izin de varsayılan olarak Yönetici izinleridir. Yönlendiriciye tünelini açmasını söyleyen komut, Commands API üzerinden gönderilemez (403 rpc_method_reserved yanıtı verir); bu rotalar tek yoldur, dolayısıyla her oturum denetlenir, sınırlandırılır ve kaydedilir.

Oturumun kime ait olduğu

Bir anahtarla açılan oturum, anahtarın sahibi adına açılır: oturum listesi sahibini Açan altında gösterir ve denetim günlüğü onları kaydeder. Yalnızca oturumu açan kişi olarak yapılan istekler oturum için bir giriş bağlantısı alabilir; bu yüzden sahibi uygulamadan oturuma yeniden girebilir. iot_remote_access.panel.open iznine sahip herhangi bir üye veya anahtar, kuruluşun herhangi bir oturumunu kapatabilir.

Oturum, sahibi kuruluştan ayrıldığında veya erişimi değiştiğinde sona erer; tıpkı uygulamada açılmış bir oturum gibi. Anahtarın iptali, zaten açtığı oturumları kapatmaz: programınız işini bitirdiğinde bunları DELETE ile kapatın.

Uyarı

Giriş bağlantısı (openUrl) bir kimlik bilgisidir. 60 saniye içinde ilk açan kişi, Hermetry’ye oturum açmadan yönlendiricinin paneline girer. Yalnızca ihtiyacı olan kişiye, güvendiğiniz bir kanal üzerinden verin ve asla bir günlüğe yazmayın.

Önce bir yönlendiriciyi kontrol edin

GET /api/iot/devices/{deviceId}/remote-access

{ "configured": true, "available": false, "reason": "offline", "metered": false, "open": [] }

Oturum açılabiliyorsa reason null olur; aksi halde not_configured, device_not_found, not_claimed, unsupported, device_not_active, certificate_inactive veya offline değerlerinden biri olur (açma rotasının reddettiği nedenlerin aynısı). Yönlendirici mobil bağlantısındaysa metered true olur. open yönlendiricinin açık oturumlarını listeler.

Bir oturum açın

POST /api/iot/remote-access/sessions

AlanKural
deviceIdZorunlu. Yönlendiricinin cihaz kimliği
targetpanel (varsayılan ve tek değer)
confirmMobil bağlantıdaki veri sınırını kabul etmek için true

Gövde katıdır: bilinmeyen bir alan 400 hatasıdır.

Mobil (LTE) bağlantıda ilk çağrı hiçbir şey oluşturmaz ve 200 { "requiresConfirm": "metered", "capBytes": 52428800 } yanıtını verir: oturumun kapatılmadan önce taşıyabileceği bayt sayısı. Aynı gövdeyi "confirm": true ile tekrar gönderin.

curl -X POST 'https://<your-host>/tenant/{tenantId}/api/iot/remote-access/sessions' \
  -H 'Authorization: Bearer sk_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"deviceId":"6f1c…","confirm":true}'

Çağrı, yönlendiricinin kabul etmesi için en fazla 15 saniye bekler. Ardından 201 yanıtı verir:

{
  "sessionId": "dk3v…",
  "openUrl": "https://dk3v….<panel domain>/__open?t=…",
  "expiresAt": "2026-11-17T14:00:00.000Z",
  "metered": false
}

expiresAt kesin bitiştir: açılıştan 4 saat sonra. Yönlendirici tünelini 90 saniye içinde bağlamalıdır; aksi halde oturum sona erer (no_dial).

Yeni giriş bağlantısı

POST /api/iot/remote-access/sessions/{sessionId} (gövdesiz) yeni tek kullanımlık bir bağlantıyla 200 { "openUrl": "…" } yanıtı verir; örneğin ilk bağlantı kullanılmadan süresi dolduğunda. Yalnızca oturumu açan kişi bağlantı alır.

Bir oturumu kapatın

DELETE /api/iot/remote-access/sessions/{sessionId} oturumu hemen sonlandırır: tarayıcı sekmesi yaklaşık bir saniye içinde çalışmayı durdurur ve yönlendiriciye tünelini kapatması bildirilir. Yanıt 200 { "session": {...} } olur. Zaten sona ermiş bir oturumu kapatmak aynı yanıtı verir; hiçbir şey iki kez kaydedilmez.

Oturumları listeleyin

GET /api/iot/remote-access/sessions?state=all&deviceId=…&limit=100

ParametreDeğerlerVarsayılan
stateopen veya allopen
deviceIdBir cihaz kimliğitüm yönlendiriciler
limit1 veya daha fazla; en fazla 500 satır döner100

Bilinmeyen parametreler 400 ile reddedilir. Oturumlar en yeniden en eskiye sıralanır:

{
  "sessions": [
    {
      "sessionId": "dk3v…", "deviceId": "6f1c…", "userId": "u-55…", "state": "CONNECTED",
      "closeReason": null, "metered": false,
      "createdAt": "2026-11-17T10:00:00.000Z", "expiresAt": "2026-11-17T14:00:00.000Z",
      "connectedAt": "2026-11-17T10:00:04.000Z", "lastActivityAt": "2026-11-17T10:12:40.000Z", "closedAt": null,
      "bytesUp": 182044, "bytesDown": 5310221, "mine": true
    }
  ],
  "usage": { "monthBytes": 734003200, "monthBytesLimit": 10737418240, "openLimit": 10, "open": 2 }
}

state, PENDING (yönlendiricinin yanıtı bekleniyor), CONNECTED veya CLOSED olur. closeReason, Uzaktan erişim sınırları ve denetim sayfasındaki kodlardan biridir. mine, anahtarın sahibi tarafından açılan oturumlar için true olur. usage içinde null sınır, planınızda sınır olmadığı anlamına gelir. Sona ermiş oturumlar 180 gün saklanır.

Reddetmeler

Her red details.reason alanını taşır.

Durumdetails.reasoncodeMesaj
404device_not_foundNOT_FOUNDCihaz bulunamadı.
409not_claimedCONFLICTReddedildi: cihaz, sahiplenilmiş lisanslı bir yönlendirici değil
409unsupportedCONFLICTBu yönlendirici henüz panel erişimini desteklemiyor. Yazılımını güncelleyin.
409device_not_activeCONFLICTCihaz etkin değil.
409certificate_inactiveCONFLICTYönlendiricinin geçerli bir sertifikası yok. Yeniden sağlayın.
409offlineCONFLICTYönlendirici çevrimdışı.
403monthly_bytesQUOTA_EXCEEDEDBu ayki panel veri kotası tükendi. (details.limit)
409device_busyCONFLICTBu yönlendiricinin zaten 3 açık panel oturumu var. Önce birini kapatın.
403tenant_limitQUOTA_EXCEEDEDPlanınızın açık panel oturumu sınırına ulaşıldı. Önce birini kapatın. (details.limit, details.current)
409opt_inCONFLICTBu yönlendiricide panel erişimi kapalı. Yönlendiricinin Cloud sayfasında “Panel erişimine bulut hesabımdan izin ver” seçeneğini açın.
409router_busyCONFLICTYönlendirici reddetti: izin verdiği en fazla panel oturumuna zaten sahip.
409router_refusedCONFLICTYönlendirici panel oturumunu reddetti. (details.error)
504router_unreachablePROVIDER_UNAVAILABLEYönlendirici yanıt vermedi. Biraz sonra tekrar deneyin.
503not_configuredPROVIDER_UNAVAILABLEPanel erişimi bu kurulumda ayarlanmamış.
404session_not_foundNOT_FOUNDPanel oturumu bulunamadı.
409session_closedCONFLICTBu panel oturumu sona erdi.
403not_openerFORBIDDENBu panel oturumuna yalnızca oturumu açan kişi girebilir.

Yalnızca router_unreachable ve offline için, bir süre bekleyip yeniden deneyin. opt_in için yönlendiricinin başında biri panel erişimini açmalıdır; bu Hermetry’den yapılamaz.

Sınırlar

SınırDeğer
Yönlendirici başına açık oturum3
Kuruluş başına açık oturumPlanınızın değeri (usage.openLimit)
Ay başına panel verisiPlanınızın değeri (usage.monthBytesLimit)
Oturum süresiAçılıştan itibaren 4 saat, etkinlikten bağımsız
Boşta kalma zaman aşımıTrafik olmadan 30 dakika
Giriş bağlantısıTek kullanım, 60 saniye içinde
Yönlendiricinin bağlanması gerekir90 saniye içinde
Mobil bağlantıda veri sınırıOturum başına capBytes