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öntem | Yol | İzin | İşlevi |
|---|---|---|---|
| GET | /api/iot/devices/{deviceId}/remote-access | iot_remote_access.panel.open | Bu yönlendiricide bir oturumun açılıp açılamayacağı ve açık oturumları |
| POST | /api/iot/remote-access/sessions | iot_remote_access.panel.open | Bir panel oturumu aç |
| POST | /api/iot/remote-access/sessions/{sessionId} | iot_remote_access.panel.open | Oturumu açanın için yeni bir giriş bağlantısı |
| DELETE | /api/iot/remote-access/sessions/{sessionId} | iot_remote_access.panel.open | Bir oturumu kapat |
| GET | /api/iot/remote-access/sessions | iot_remote_access.sessions.read | Kuruluş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
| Alan | Kural |
|---|---|
deviceId | Zorunlu. Yönlendiricinin cihaz kimliği |
target | panel (varsayılan ve tek değer) |
confirm | Mobil 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
| Parametre | Değerler | Varsayılan |
|---|---|---|
state | open veya all | open |
deviceId | Bir cihaz kimliği | tüm yönlendiriciler |
limit | 1 veya daha fazla; en fazla 500 satır döner | 100 |
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.
| Durum | details.reason | code | Mesaj |
|---|---|---|---|
| 404 | device_not_found | NOT_FOUND | Cihaz bulunamadı. |
| 409 | not_claimed | CONFLICT | Reddedildi: cihaz, sahiplenilmiş lisanslı bir yönlendirici değil |
| 409 | unsupported | CONFLICT | Bu yönlendirici henüz panel erişimini desteklemiyor. Yazılımını güncelleyin. |
| 409 | device_not_active | CONFLICT | Cihaz etkin değil. |
| 409 | certificate_inactive | CONFLICT | Yönlendiricinin geçerli bir sertifikası yok. Yeniden sağlayın. |
| 409 | offline | CONFLICT | Yönlendirici çevrimdışı. |
| 403 | monthly_bytes | QUOTA_EXCEEDED | Bu ayki panel veri kotası tükendi. (details.limit) |
| 409 | device_busy | CONFLICT | Bu yönlendiricinin zaten 3 açık panel oturumu var. Önce birini kapatın. |
| 403 | tenant_limit | QUOTA_EXCEEDED | Planınızın açık panel oturumu sınırına ulaşıldı. Önce birini kapatın. (details.limit, details.current) |
| 409 | opt_in | CONFLICT | Bu yönlendiricide panel erişimi kapalı. Yönlendiricinin Cloud sayfasında “Panel erişimine bulut hesabımdan izin ver” seçeneğini açın. |
| 409 | router_busy | CONFLICT | Yönlendirici reddetti: izin verdiği en fazla panel oturumuna zaten sahip. |
| 409 | router_refused | CONFLICT | Yönlendirici panel oturumunu reddetti. (details.error) |
| 504 | router_unreachable | PROVIDER_UNAVAILABLE | Yönlendirici yanıt vermedi. Biraz sonra tekrar deneyin. |
| 503 | not_configured | PROVIDER_UNAVAILABLE | Panel erişimi bu kurulumda ayarlanmamış. |
| 404 | session_not_found | NOT_FOUND | Panel oturumu bulunamadı. |
| 409 | session_closed | CONFLICT | Bu panel oturumu sona erdi. |
| 403 | not_opener | FORBIDDEN | Bu 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ır | Değer |
|---|---|
| Yönlendirici başına açık oturum | 3 |
| Kuruluş başına açık oturum | Planınızın değeri (usage.openLimit) |
| Ay başına panel verisi | Planınızın değeri (usage.monthBytesLimit) |
| Oturum süresi | Açı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ı gerekir | 90 saniye içinde |
| Mobil bağlantıda veri sınırı | Oturum başına capBytes |

