सीधे कंटेंट पर जाएँ
Localtonet Localtonet डैशबोर्ड

वेबहुक

इस पेज पर मदद पाएँ
इस पेज पर 9 सेक्शन
  1. यह कैसे काम करता है
  2. शुरू करने से पहले
  3. वेबहुक बनाएँ
  4. वेबहुक खोलें
  5. चुनें कि किस बारे में सूचना चाहिए
  6. बनाएँ
  7. वेबहुक सूची
  8. Localtonet जो रिक्वेस्ट भेजता है
  9. डिलीवरी
  10. उदाहरण रिसीवर
  11. अपने वेबहुक को टेस्ट करें
  12. समस्या निवारण
  13. संबंधित पेज

वेबहुक Localtonet को आपके किसी URL को तब कॉल करने देता है जब कोई डिवाइस (AuthToken) या टनल कनेक्ट या डिस्कनेक्ट होता है। इसका इस्तेमाल अपनी टीम को अलर्ट करने, कोई सर्विस रीस्टार्ट करने, या अपना स्टेटस पेज अपडेट रखने के लिए करें।

यह कैसे काम करता है #

  • वेबहुक एक टोकन ग्रुप का होता है। आपकी पसंद के अनुसार वह उस ग्रुप के AuthToken, उन टोकन के टनल, या दोनों पर नज़र रखता है।
  • जब किसी देखे जा रहे टोकन या टनल की स्थिति कनेक्टेड या डिस्कनेक्टेड हो जाती है, तब Localtonet आपके URL पर एक छोटी JSON बॉडी के साथ HTTP POST रिक्वेस्ट भेजता है।
  • आप चुनते हैं कि दोनों इवेंट में से कौन-सा चाहिए: कनेक्ट होना, डिस्कनेक्ट होना, या दोनों।

शुरू करने से पहले #

  • एक टोकन ग्रुप जिसमें वे AuthToken हों जिन पर आप नज़र रखना चाहते हैं। ग्रुप मेरे टोकन के अंतर्गत बनाएँ; देखें AuthToken।
  • एक HTTP या HTTPS एंडपॉइंट जो इंटरनेट से पहुँचने योग्य हो और JSON बॉडी वाली POST रिक्वेस्ट स्वीकार करता हो।
  • आपके अपने खाते का डैशबोर्ड। टीम डैशबोर्ड में काम करते समय वेबहुक मेनू आइटम नहीं दिखता।

वेबहुक बनाएँ #

  1. वेबहुक खोलें #

    डैशबोर्ड मेनू में वेबहुक खोलें।

  2. चुनें कि किस बारे में सूचना चाहिए #

    सेटिंगयह क्या करता है
    टोकन वेबहुक चालू करेंग्रुप का कोई AuthToken कनेक्ट या डिस्कनेक्ट होने पर रिक्वेस्ट भेजती है, यानी जब उस डिवाइस का Localtonet क्लाइंट ऑनलाइन आता है या ऑफ़लाइन जाता है।
    टनल वेबहुक चालू करेंग्रुप के किसी AuthToken का टनल कनेक्ट या डिस्कनेक्ट होने पर रिक्वेस्ट भेजती है।
    कनेक्ट होने पर भेजेंकनेक्टेड में बदलाव के लिए रिक्वेस्ट भेजती है।
    डिस्कनेक्ट होने पर भेजेंडिस्कनेक्टेड में बदलाव के लिए रिक्वेस्ट भेजती है।
    Auth Token ग्रुपजिस टोकन ग्रुप पर नज़र रखनी है। ज़रूरी।
    वेबहुक URLवह एड्रेस जिसे Localtonet कॉल करता है। ज़रूरी।

    दोनों वेबहुक टाइप में से कम से कम एक और दोनों नोटिफ़िकेशन टाइप में से कम से कम एक चालू करें।

  3. बनाएँ #

    बनाएँ चुनें। वेबहुक फ़ॉर्म के नीचे की सूची में दिखता है।

वेबहुक सूची #

हर पंक्ति टोकन वेबहुक, टनल वेबहुक, ग्रुप का नाम, URL, कनेक्ट होने की सूचना और डिस्कनेक्ट होने की सूचना दिखाती है, हर स्विच सक्रिय या निष्क्रिय के रूप में। एक्शन कॉलम का डिलीट बटन पुष्टि करने के बाद वेबहुक हटा देता है।

वेबहुक को एडिट नहीं किया जा सकता। उसका URL, ग्रुप या स्विच बदलने के लिए उसे हटाकर नया बनाएँ। आप एक ही ग्रुप के लिए कई वेबहुक बना सकते हैं, जैसे कनेक्ट होने के लिए एक URL और डिस्कनेक्ट होने के लिए दूसरा।

Localtonet जो रिक्वेस्ट भेजता है #

हिस्सामान
मेथडPOST
कंटेंट टाइपapplication/json; charset=utf-8
बॉडीनीचे दिए चार फ़ील्ड वाला एक JSON ऑब्जेक्ट।
फ़ील्डमतलबमान
Idउस टोकन या टनल की पहचान करता है जिसके बारे में इवेंट है।Type Token के लिए: AuthToken की पहचान। Type Tunnel के लिए: टनल की संख्यात्मक ID, स्ट्रिंग के रूप में भेजी गई। यह वही ID है जिसे API tunnelId के रूप में इस्तेमाल करता है।
ActionDateLocaltonet ने बदलाव कब दर्ज किया।ISO 8601 फ़ॉर्मैट में तारीख और समय
Typeऑब्जेक्ट का प्रकार।Token या Tunnel
Statusनई स्थिति।Connected या Disconnected

टोकन इवेंट:

रिक्वेस्ट बॉडी
{
  "Id": "<YOUR_TOKEN>",
  "ActionDate": "2026-01-15T10:30:00.1234567+03:00",
  "Type": "Token",
  "Status": "Disconnected"
}

टनल इवेंट:

रिक्वेस्ट बॉडी
{
  "Id": "<TUNNEL_ID>",
  "ActionDate": "2026-01-15T10:31:12.7654321+03:00",
  "Type": "Tunnel",
  "Status": "Connected"
}

डिलीवरी #

  • विफल कॉल दोहराई नहीं जाती, इसलिए आपका एंडपॉइंट उपलब्ध होना चाहिए और जल्दी जवाब देना चाहिए।
  • रिक्वेस्ट में कोई सिग्नेचर या सीक्रेट हेडर नहीं होता। यह पक्का करने के लिए कि कॉल आपके वेबहुक से ही आई है, URL में एक लंबा रैंडम मान रखें, जैसे पाथ सेगमेंट या क्वेरी पैरामीटर के रूप में, और उसे अपने रिसीवर में जाँचें।
  • डिस्कनेक्ट की रिपोर्ट तब दी जाती है जब Localtonet दर्ज करता है कि क्लाइंट जा चुका है, जो डिवाइस का कनेक्शन टूटने के क्षण से थोड़ी देर बाद हो सकता है।
  • ActionDate को मानक ISO 8601 पार्सर से पार्स करें और उसमें मौजूद ऑफ़सेट इस्तेमाल करें; कोई तय टाइम ज़ोन न मानें।

उदाहरण रिसीवर #

कोई भी वेब फ्रेमवर्क चलेगा। रिसीवर को सिर्फ़ JSON बॉडी पढ़नी है और सफलता वाले स्टेटस से जवाब देना है। Node.js के साथ बिना किसी डिपेंडेंसी का एक न्यूनतम वर्शन:

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);

इस रिसीवर के साथ वेबहुक URL https://<YOUR_HOST>/localtonet/<YOUR_SECRET> होता है।

अपने वेबहुक को टेस्ट करें #

  1. किसी टेस्ट डिवाइस का एक AuthToken वेबहुक के टोकन ग्रुप में डालें।
  2. उस डिवाइस पर टोकन के साथ Localtonet क्लाइंट शुरू करें। अगर कनेक्ट होने पर भेजें चालू है, तो आपके एंडपॉइंट को Type Token, Status Connected मिलता है।
  3. क्लाइंट को Ctrl + C से रोकें। आपके एंडपॉइंट को Status Disconnected मिलता है।
  4. अगर टनल वेबहुक चालू करें चालू है, तो टनल इवेंट पाने के लिए उस टोकन का कोई टनल मेरे टनल में शुरू और बंद करें।

अभी कोई पब्लिक एंडपॉइंट नहीं है? रिसीवर को अपने कंप्यूटर पर चलाएँ और उसे Localtonet HTTP टनल से पब्लिश करें, उस AuthToken से अलग AuthToken पर जिस पर आप नज़र रख रहे हैं। तब टनल का रिक्वेस्ट इंस्पेक्टर हर वेबहुक कॉल दिखाता है; देखें लॉग और निरीक्षण।

समस्या निवारण #

"कम से कम एक वेबहुक टाइप चालू करें।" या "कम से कम एक नोटिफ़िकेशन टाइप चालू करें।"

बनाएँ चुनने से पहले टोकन वेबहुक चालू करें या टनल वेबहुक चालू करें, और कनेक्ट होने पर भेजें या डिस्कनेक्ट होने पर भेजें चालू करें।

"ग्रुप ज़रूरी है!"

Auth Token ग्रुप के नीचे कोई टोकन ग्रुप चुनें। अगर सूची खाली है, तो मेरे टोकन में एक ग्रुप बनाएँ और उसमें अपने टोकन जोड़ें।

कोई रिक्वेस्ट नहीं आती

जाँचें कि डिवाइस का AuthToken उस ग्रुप का सदस्य है जिस पर वेबहुक नज़र रखता है, सूची में मेल खाते स्विच सक्रिय दिखा रहे हैं, और URL इंटरनेट से पहुँचने योग्य है (localhost या प्राइवेट एड्रेस नहीं)। URL को खुद टेस्ट करें:

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"}'
मुझे टोकन इवेंट मिलते हैं लेकिन टनल इवेंट नहीं

वेबहुक के लिए टनल वेबहुक सक्रिय होना चाहिए, और टनल उस AuthToken का होना चाहिए जो ग्रुप में है।

सपोर्ट