Webhook'lar
Bu sayfada 9 bölüm
Webhook, bir cihaz (AuthToken) veya tünel bağlandığında ya da bağlantısı kesildiğinde Localtonet'in sizin bir URL'nizi çağırmasını sağlar. Ekibinizi uyarmak, bir hizmeti yeniden başlatmak veya kendi durum sayfanızı güncel tutmak için kullanın.
Nasıl çalışır #
- Bir webhook bir token grubuna aittir. Seçiminize göre o gruptaki AuthToken'ları, bu token'ların tünellerini veya her ikisini izler.
- İzlenen bir token veya tünelin durumu bağlandı ya da bağlantısı kesildi olarak değiştiğinde Localtonet, URL'nize küçük bir JSON gövdesi içeren bir HTTP
POSTisteği gönderir. - İki olaydan hangisini istediğinizi seçersiniz: bağlandı, bağlantısı kesildi veya her ikisi.
Başlamadan önce #
- İzlemek istediğiniz AuthToken'ları içeren bir token grubu. Grupları Token'larım sayfasında oluşturun; bkz. AuthToken'lar.
- İnternetten erişilebilen ve JSON gövdeli bir
POSTisteğini kabul eden bir HTTP veya HTTPS uç noktası. - Kendi hesap paneliniz. Bir ekip panelinde çalışırken Webhook'lar menü öğesi gösterilmez.
Webhook oluşturma #
-
Webhook'ları açın #
Panel menüsünden Webhook'lar sayfasını açın.
-
Neyden haberdar olmak istediğinizi seçin #
Ayar Ne yapar Token Webhook'u Etkin Grubun bir AuthToken'ı bağlandığında veya bağlantısı kesildiğinde, yani o cihazın Localtonet istemcisi çevrimiçi veya çevrimdışı olduğunda bir istek gönderir. Tünel Webhook'u Etkin Grubun bir AuthToken'ına ait bir tünel bağlandığında veya bağlantısı kesildiğinde bir istek gönderir. Bağlandığında Gönder Bağlandı durumuna geçiş için isteği gönderir. Bağlantı Kesildiğinde Gönder Bağlantısı kesildi durumuna geçiş için isteği gönderir. AuthToken Grubu İzlenecek token grubu. Zorunludur. Webhook URL'si Localtonet'in çağırdığı adres. Zorunludur. İki webhook türünden en az birini ve iki bildirim türünden en az birini açın.
-
Oluştur #
Oluştur düğmesini seçin. Webhook, formun altındaki listede görünür.
Webhook listesi #
Her satır Token Webhook'u, Tünel Webhook'u, Grup Adı, URL, Bağlantı Bildirimi ve Kopma Bildirimi değerlerini gösterir; her anahtar Aktif veya Pasif olarak görünür. İşlem sütunundaki sil düğmesi, onayladıktan sonra webhook'u kaldırır.
Bir webhook düzenlenemez. URL'sini, grubunu veya anahtarlarını değiştirmek için onu silin ve yenisini oluşturun. Aynı grup için birden çok webhook oluşturabilirsiniz; örneğin bağlanmalar için bir URL, bağlantı kesilmeleri için başka bir URL.
Localtonet'in gönderdiği istek #
| Bölüm | Değer |
|---|---|
| Yöntem | POST |
| İçerik türü | application/json; charset=utf-8 |
| Gövde | Aşağıdaki dört alana sahip bir JSON nesnesi. |
| Alan | Anlamı | Değerler |
|---|---|---|
Id | Olayın hangi token veya tünel hakkında olduğunu belirtir. | Type değeri Token ise: AuthToken'ı belirtir. Type değeri Tunnel ise: tünelin sayısal kimliği, bir dize olarak gönderilir. API'nin tunnelId olarak kullandığı kimlikle aynıdır. |
ActionDate | Localtonet'in değişikliği kaydettiği zaman. | ISO 8601 biçiminde tarih ve saat |
Type | Nesnenin türü. | Token veya Tunnel |
Status | Yeni durum. | Connected veya Disconnected |
Bir token olayı:
{
"Id": "<YOUR_TOKEN>",
"ActionDate": "2026-01-15T10:30:00.1234567+03:00",
"Type": "Token",
"Status": "Disconnected"
}Bir tünel olayı:
{
"Id": "<TUNNEL_ID>",
"ActionDate": "2026-01-15T10:31:12.7654321+03:00",
"Type": "Tunnel",
"Status": "Connected"
}Teslim #
- Başarısız bir çağrı tekrarlanmaz; bu nedenle uç noktanız erişilebilir olmalı ve hızlı yanıt vermelidir.
- İsteğin imza veya gizli anahtar başlığı yoktur. Bir çağrının webhook'unuzdan geldiğinden emin olmak için URL'ye uzun, rastgele bir değer koyun; örneğin yol bölümü veya sorgu parametresi olarak, ve bunu alıcınızda denetleyin.
- Bağlantı kesilmesi, Localtonet istemcinin gittiğini kaydettiğinde bildirilir; bu, cihazın bağlantısını kaybettiği andan biraz sonra olabilir.
ActionDatedeğerini standart bir ISO 8601 ayrıştırıcısıyla ayrıştırın ve taşıdığı saat farkını kullanın; sabit bir saat dilimi varsaymayın.
Örnek alıcı #
Her web çatısı çalışır. Alıcının yalnızca JSON gövdesini okuyup başarı durumuyla yanıt vermesi gerekir. Node.js ile ve bağımlılık olmadan en basit sürüm:
const http = require('http');
http.createServer((req, res) => {
let body = '';
req.on('data', chunk => body += chunk);
req.on('end', () => {
if (req.method === 'POST' && req.url === '/localtonet/<YOUR_SECRET>') {
const event = JSON.parse(body);
console.log(event.Type, event.Status, event.ActionDate);
}
res.writeHead(200);
res.end();
});
}).listen(8080);Bu alıcıyla Webhook URL'si https://<YOUR_HOST>/localtonet/<YOUR_SECRET> olur.
Webhook'unuzu test edin #
- Bir test cihazının AuthToken'larından birini webhook'un token grubuna koyun.
- O cihazda Localtonet istemcisini token ile başlatın. Bağlandığında Gönder açıksa uç noktanız
TypeToken,StatusConnectedalır. - İstemciyi Ctrl + C ile durdurun. Uç noktanız
StatusDisconnectedalır. - Tünel Webhook'u Etkin açıksa tünel olaylarını almak için Tünellerim altında o token'a ait bir tüneli başlatın ve durdurun.
Henüz herkese açık bir uç noktanız yok mu? Alıcıyı bilgisayarınızda çalıştırın ve izlediğiniz token'dan farklı bir AuthToken üzerindeki bir Localtonet HTTP tüneliyle yayınlayın. Tünelin istek denetleyicisi o zaman her webhook çağrısını gösterir; bkz. Günlükler ve inceleme.
Sorun giderme #
"En az bir webhook türünü açın." veya "En az bir bildirim türünü açın."
Oluştur düğmesini seçmeden önce Token Webhook'u Etkin veya Tünel Webhook'u Etkin ile Bağlandığında Gönder veya Bağlantı Kesildiğinde Gönder seçeneklerini açın.
"Grup gereklidir!"
AuthToken Grubu altında bir token grubu seçin. Liste boşsa Token'larım sayfasında bir grup oluşturun ve token'larınızı ona ekleyin.
Hiç istek gelmiyor
Cihazın AuthToken'ının webhook'un izlediği grubun üyesi olduğunu, ilgili anahtarların listede Aktif göründüğünü ve URL'nin internetten erişilebilir olduğunu (localhost veya özel bir adres olmadığını) kontrol edin. URL'yi kendiniz test edin:
curl -X POST "<YOUR_WEBHOOK_URL>" \
-H "Content-Type: application/json" \
-d '{"Id":"test","ActionDate":"2026-01-15T10:30:00+00:00","Type":"Token","Status":"Connected"}'Token olayları alıyorum ama tünel olayları gelmiyor
Webhook için Tünel Webhook'u Aktif olmalı ve tünel, gruptaki bir AuthToken'a ait olmalıdır.