İçeriğe geç
Localtonet Localtonet Panel

Webhook'lar

Bu sayfa için yardım al
Bu sayfada 9 bölüm
  1. Nasıl çalışır
  2. Başlamadan önce
  3. Webhook oluşturma
  4. Webhook'ları açın
  5. Neyden haberdar olmak istediğinizi seçin
  6. Oluştur
  7. Webhook listesi
  8. Localtonet'in gönderdiği istek
  9. Teslim
  10. Örnek alıcı
  11. Webhook'unuzu test edin
  12. Sorun giderme
  13. İlgili sayfalar

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 POST isteğ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 POST isteğ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 #

  1. Webhook'ları açın #

    Panel menüsünden Webhook'lar sayfasını açın.

  2. Neyden haberdar olmak istediğinizi seçin #

    AyarNe yapar
    Token Webhook'u EtkinGrubun 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 EtkinGrubun bir AuthToken'ına ait bir tünel bağlandığında veya bağlantısı kesildiğinde bir istek gönderir.
    Bağlandığında GönderBağlandı durumuna geçiş için isteği gönderir.
    Bağlantı Kesildiğinde GönderBağlantısı kesildi durumuna geçiş için isteği gönderir.
    AuthToken Grubuİzlenecek token grubu. Zorunludur.
    Webhook URL'siLocaltonet'in çağırdığı adres. Zorunludur.

    İki webhook türünden en az birini ve iki bildirim türünden en az birini açın.

  3. 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ümDeğer
YöntemPOST
İçerik türüapplication/json; charset=utf-8
GövdeAşağıdaki dört alana sahip bir JSON nesnesi.
AlanAnlamıDeğerler
IdOlayı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.
ActionDateLocaltonet'in değişikliği kaydettiği zaman.ISO 8601 biçiminde tarih ve saat
TypeNesnenin türü.Token veya Tunnel
StatusYeni durum.Connected veya Disconnected

Bir token olayı:

İstek gövdesi
{
  "Id": "<YOUR_TOKEN>",
  "ActionDate": "2026-01-15T10:30:00.1234567+03:00",
  "Type": "Token",
  "Status": "Disconnected"
}

Bir tünel olayı:

İstek gövdesi
{
  "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.
  • ActionDate değ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:

receiver.js
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 #

  1. Bir test cihazının AuthToken'larından birini webhook'un token grubuna koyun.
  2. O cihazda Localtonet istemcisini token ile başlatın. Bağlandığında Gönder açıksa uç noktanız Type Token, Status Connected alır.
  3. İstemciyi Ctrl + C ile durdurun. Uç noktanız Status Disconnected alır.
  4. 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:

Bash
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.

Bu sayfa için yardıma mı ihtiyacınız var? Topluluğa sorun veya bir destek talebi açın.

Destek