वेबहुक
इस पेज पर 9 सेक्शन
वेबहुक Localtonet को आपके किसी URL को तब कॉल करने देता है जब कोई डिवाइस (AuthToken) या टनल कनेक्ट या डिस्कनेक्ट होता है। इसका इस्तेमाल अपनी टीम को अलर्ट करने, कोई सर्विस रीस्टार्ट करने, या अपना स्टेटस पेज अपडेट रखने के लिए करें।
यह कैसे काम करता है #
- वेबहुक एक टोकन ग्रुप का होता है। आपकी पसंद के अनुसार वह उस ग्रुप के AuthToken, उन टोकन के टनल, या दोनों पर नज़र रखता है।
- जब किसी देखे जा रहे टोकन या टनल की स्थिति कनेक्टेड या डिस्कनेक्टेड हो जाती है, तब Localtonet आपके URL पर एक छोटी JSON बॉडी के साथ HTTP
POSTरिक्वेस्ट भेजता है। - आप चुनते हैं कि दोनों इवेंट में से कौन-सा चाहिए: कनेक्ट होना, डिस्कनेक्ट होना, या दोनों।
शुरू करने से पहले #
- एक टोकन ग्रुप जिसमें वे AuthToken हों जिन पर आप नज़र रखना चाहते हैं। ग्रुप मेरे टोकन के अंतर्गत बनाएँ; देखें AuthToken।
- एक HTTP या HTTPS एंडपॉइंट जो इंटरनेट से पहुँचने योग्य हो और JSON बॉडी वाली
POSTरिक्वेस्ट स्वीकार करता हो। - आपके अपने खाते का डैशबोर्ड। टीम डैशबोर्ड में काम करते समय वेबहुक मेनू आइटम नहीं दिखता।
वेबहुक बनाएँ #
-
वेबहुक खोलें #
डैशबोर्ड मेनू में वेबहुक खोलें।
-
चुनें कि किस बारे में सूचना चाहिए #
सेटिंग यह क्या करता है टोकन वेबहुक चालू करें ग्रुप का कोई AuthToken कनेक्ट या डिस्कनेक्ट होने पर रिक्वेस्ट भेजती है, यानी जब उस डिवाइस का Localtonet क्लाइंट ऑनलाइन आता है या ऑफ़लाइन जाता है। टनल वेबहुक चालू करें ग्रुप के किसी AuthToken का टनल कनेक्ट या डिस्कनेक्ट होने पर रिक्वेस्ट भेजती है। कनेक्ट होने पर भेजें कनेक्टेड में बदलाव के लिए रिक्वेस्ट भेजती है। डिस्कनेक्ट होने पर भेजें डिस्कनेक्टेड में बदलाव के लिए रिक्वेस्ट भेजती है। Auth Token ग्रुप जिस टोकन ग्रुप पर नज़र रखनी है। ज़रूरी। वेबहुक URL वह एड्रेस जिसे Localtonet कॉल करता है। ज़रूरी। दोनों वेबहुक टाइप में से कम से कम एक और दोनों नोटिफ़िकेशन टाइप में से कम से कम एक चालू करें।
-
बनाएँ #
बनाएँ चुनें। वेबहुक फ़ॉर्म के नीचे की सूची में दिखता है।
वेबहुक सूची #
हर पंक्ति टोकन वेबहुक, टनल वेबहुक, ग्रुप का नाम, URL, कनेक्ट होने की सूचना और डिस्कनेक्ट होने की सूचना दिखाती है, हर स्विच सक्रिय या निष्क्रिय के रूप में। एक्शन कॉलम का डिलीट बटन पुष्टि करने के बाद वेबहुक हटा देता है।
वेबहुक को एडिट नहीं किया जा सकता। उसका URL, ग्रुप या स्विच बदलने के लिए उसे हटाकर नया बनाएँ। आप एक ही ग्रुप के लिए कई वेबहुक बना सकते हैं, जैसे कनेक्ट होने के लिए एक URL और डिस्कनेक्ट होने के लिए दूसरा।
Localtonet जो रिक्वेस्ट भेजता है #
| हिस्सा | मान |
|---|---|
| मेथड | POST |
| कंटेंट टाइप | application/json; charset=utf-8 |
| बॉडी | नीचे दिए चार फ़ील्ड वाला एक JSON ऑब्जेक्ट। |
| फ़ील्ड | मतलब | मान |
|---|---|---|
Id | उस टोकन या टनल की पहचान करता है जिसके बारे में इवेंट है। | Type Token के लिए: AuthToken की पहचान। Type Tunnel के लिए: टनल की संख्यात्मक ID, स्ट्रिंग के रूप में भेजी गई। यह वही ID है जिसे API tunnelId के रूप में इस्तेमाल करता है। |
ActionDate | Localtonet ने बदलाव कब दर्ज किया। | 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 के साथ बिना किसी डिपेंडेंसी का एक न्यूनतम वर्शन:
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> होता है।
अपने वेबहुक को टेस्ट करें #
- किसी टेस्ट डिवाइस का एक AuthToken वेबहुक के टोकन ग्रुप में डालें।
- उस डिवाइस पर टोकन के साथ Localtonet क्लाइंट शुरू करें। अगर कनेक्ट होने पर भेजें चालू है, तो आपके एंडपॉइंट को
TypeToken,StatusConnectedमिलता है। - क्लाइंट को Ctrl + C से रोकें। आपके एंडपॉइंट को
StatusDisconnectedमिलता है। - अगर टनल वेबहुक चालू करें चालू है, तो टनल इवेंट पाने के लिए उस टोकन का कोई टनल मेरे टनल में शुरू और बंद करें।
अभी कोई पब्लिक एंडपॉइंट नहीं है? रिसीवर को अपने कंप्यूटर पर चलाएँ और उसे Localtonet HTTP टनल से पब्लिश करें, उस AuthToken से अलग AuthToken पर जिस पर आप नज़र रख रहे हैं। तब टनल का रिक्वेस्ट इंस्पेक्टर हर वेबहुक कॉल दिखाता है; देखें लॉग और निरीक्षण।
समस्या निवारण #
"कम से कम एक वेबहुक टाइप चालू करें।" या "कम से कम एक नोटिफ़िकेशन टाइप चालू करें।"
बनाएँ चुनने से पहले टोकन वेबहुक चालू करें या टनल वेबहुक चालू करें, और कनेक्ट होने पर भेजें या डिस्कनेक्ट होने पर भेजें चालू करें।
"ग्रुप ज़रूरी है!"
Auth Token ग्रुप के नीचे कोई टोकन ग्रुप चुनें। अगर सूची खाली है, तो मेरे टोकन में एक ग्रुप बनाएँ और उसमें अपने टोकन जोड़ें।
कोई रिक्वेस्ट नहीं आती
जाँचें कि डिवाइस का AuthToken उस ग्रुप का सदस्य है जिस पर वेबहुक नज़र रखता है, सूची में मेल खाते स्विच सक्रिय दिखा रहे हैं, और URL इंटरनेट से पहुँचने योग्य है (localhost या प्राइवेट एड्रेस नहीं)। URL को खुद टेस्ट करें:
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 का होना चाहिए जो ग्रुप में है।