Webhooks: لنک کلکس خود بخود آپ کے سرور تک پہنچتے ہیں

Lix.li ہر کلک کا ایک ایونٹ براہ راست آپ کے URL پر HTTP POST کے ذریعے بھیجتا ہے — ریئل ٹائم میں، HMAC سے سائن شدہ، اور قابلِ اعتماد ڈیلیوری کے ساتھ۔ بار بار API پول کرنے کی ضرورت نہیں: کلک ہوتے ہی ڈیٹا خود بخود پہنچ جاتا ہے۔

Webhook سیٹ کریں ڈیٹا فارمیٹ دیکھیں

ریئل ٹائم · HMAC دستخط · دوبارہ کوشش اور ڈیلیوری لاگ

# Lix.li itself sends POST to your server during transitions POST https://your-server.com/hooks X-Lix-Signature: sha256=9f86d0818884… Content-Type: application/json { "event_type": "redirects.batch", "count": 2, "events": [ { "link_id": 9053352, "country": "DE", "device": "mobile" } ] }

Webhooks کیوں استعمال کریں

کلک کا ڈیٹا فوری طور پر پائیں اور اسی بنیاد پر اپنا ورک فلو بنائیں

ریئل ٹائم

کلک ہوتے ہی ایونٹ آ جاتا ہے۔ شیڈول کے مطابق API پول کرنے اور اپڈیٹ کا انتظار کرنے کی ضرورت نہیں۔

ہر کلک کا مکمل ڈیٹا

ملک، شہر، ڈیوائس، OS، براؤزر، ریفرر اور بوٹ فلیگ — آپ کی اپنی اینالٹکس کے لیے جو کچھ چاہیے سب مل جاتا ہے۔

ڈیفالٹ کے طور پر محفوظ

ہر ریکویسٹ آپ کے اپنے سیکرٹ سے HMAC کے ذریعے سائن ہوتی ہے، اس لیے اصل اور جعلی ایونٹس میں فرق کرنا آسان ہو جاتا ہے۔

قابلِ اعتماد ڈیلیوری

سرور ڈاؤن ہو تو ڈیلیوری دوبارہ کوشش کی جاتی ہے۔ تمام کوششیں اور ان کی حیثیت ڈیلیوری لاگ میں نظر آتی ہیں۔

استعمال کی مثالیں

کلک ایونٹس عام طور پر کہاں بھیجے جاتے ہیں

Lix.li POST
اپنی اینالٹکس یا CRM

ہر کلک کو اپنے ڈیٹابیس یا CRM میں محفوظ کریں اور اپنی مرضی کے مطابق رپورٹس بنائیں۔

Lix.li POST
چیٹ نوٹیفیکیشنز

Telegram، Slack یا Discord کا بوٹ نئے کلکس کی اطلاع فوری طور پر دے — بغیر کسی دستی جانچ کے۔

Lix.li POST
آٹومیشن

Zapier، Make یا n8n میں سینیریوز چلائیں: ایک کلک ایونٹ کسی بھی اگلے عمل کے لیے ٹریگر بن جاتا ہے۔

Webhook میں کیا کچھ آتا ہے

redirects.batch ایونٹ: ایک ہی پے لوڈ میں ایک ٹائم ونڈو کے تمام کلکس اکٹھے شامل ہوتے ہیں

{ "delivery_id": "d_01HXY9F0…", "event_type": "redirects.batch", "sent_at": "2026-08-04T10:15:00Z", "window": { "from": "…10:14:00Z", "to": "…10:15:00Z" }, "count": 1, "truncated": false, "events": [ { "event_id": "e_9f86d0…", "link_id": 9053352, "datetime": "2026-08-04T10:14:12Z", "country": "DE", "city": "Berlin", "browser": "Chrome", "os": "Android", "device": "mobile", "ref_domain": "t.me", "group_id": null, "is_bot": false } ] }

وزیٹر کا IP ایڈریس ڈیفالٹ کے طور پر نہیں بھیجا جاتا (کیونکہ یہ ذاتی ڈیٹا ہے) — یہ صرف اسی صورت شامل ہوتا ہے جب آپ متعلقہ endpoint کے لیے اسے واضح طور پر فعال کریں۔

Webhooks کیا کچھ کر سکتے ہیں

لچکدار ترتیب، مضبوط سیکیورٹی، اور پیش گوئی کے قابل ڈیلیوری

بیچ کی صورت میں ایونٹ ڈیلیوری

کلکس ایک ٹائم ونڈو میں اکٹھے (redirects.batch) آتے ہیں — اس سے آپ کے سرور پر ریکویسٹس کی تعداد کم ہو جاتی ہے۔

اپنی پسند کا دائرہ کار

اکاؤنٹ کے تمام لنکس، کوئی مخصوص گروپ، یا صرف ایک لنک — صرف وہی ایونٹس حاصل کریں جن کی آپ کو واقعی ضرورت ہے۔

HMAC دستخط

ہر ریکویسٹ آپ کے سیکرٹ سے سائن ہوتی ہے۔ سیکرٹ کو کسی بھی وقت دوبارہ جنریٹ کیا جا سکتا ہے۔

دوبارہ کوشش اور خودکار غیر فعال کاری

ناقابلِ رسائی سرور کے لیے دوبارہ کوشش کی جاتی ہے؛ مسلسل جواب نہ دینے والا endpoint خود بخود غیر فعال ہو جاتا ہے۔

ڈیلیوری لاگ

ہر بھیجی گئی ریکویسٹ کی حیثیت اور مواد کے ساتھ مکمل تاریخ — کسی مسئلے کی صورت میں وجہ تلاش کرنا آسان ہو جاتا ہے۔

ٹیسٹ بھیجیں (ping)

اصل ٹریفک آنے سے پہلے ایک کلک میں انٹیگریشن چیک کریں — آپ کے سرور کو ایک ٹیسٹ ایونٹ موصول ہوگا۔

ہر ایونٹ کا بھرپور ڈیٹا

ہر کلک کے ساتھ link_id، وقت، ملک، شہر، OS، ڈیوائس، براؤزر، ریفرر اور بوٹ فلیگ شامل ہوتا ہے۔

ڈیفالٹ کے طور پر پرائیویسی

جب تک آپ کسی مخصوص endpoint کے لیے اسے واضح طور پر فعال نہ کریں، IP ایڈریس نہیں بھیجا جاتا۔

مفت آزمائیں

Webhook کیسے سیٹ کریں

پانچ مراحل — سرور کا URL درج کرنے سے لے کر کلک ایونٹس کی مسلسل سٹریم تک

1
Endpoint بنائیں

Lix.li پر سائن اپ کریں، Webhooks سیکشن کھولیں اور اپنے سرور کا وہ URL درج کریں جہاں Lix.li کلک ایونٹس بھیجے گا۔

2
دائرہ کار منتخب کریں

یہ طے کریں کہ کن لنکس کے ایونٹس چاہییں: اکاؤنٹ کے تمام لنکس، کوئی مخصوص گروپ، یا صرف ایک لنک۔

3
سائننگ سیکرٹ محفوظ کریں

Lix.li آپ کو ایک سیکرٹ کی فراہم کرے گا۔ ہر ریکویسٹ HMAC سے سائن ہوتی ہے — ہیڈر میں دستخط ملا کر یقین کریں کہ ایونٹ واقعی Lix.li سے آیا ہے۔

4
ایک ٹیسٹ ریکویسٹ بھیجیں

"Test" (ping) پر کلک کریں اور دیکھیں کہ آپ کا سرور ریکویسٹ قبول کر کے 2xx جواب دیتا ہے یا نہیں۔ اس طرح اصل ٹریفک آنے سے پہلے ہی انٹیگریشن کی تصدیق ہو جاتی ہے۔

5
ڈیلیوری لاگ پر نظر رکھیں

لاگ میں ہر بھیجی گئی ریکویسٹ، اس کی حیثیت اور دوبارہ کوششیں نظر آتی ہیں۔ سرور ناقابلِ رسائی ہو تو ڈیلیوری دوبارہ کوشش کی جاتی ہے، اور مسلسل جواب نہ دینے والا endpoint خود بخود غیر فعال ہو جاتا ہے۔

Webhook سیٹ کریں

Webhooks سے متعلق عمومی سوالات

Webhook ایک HTTP نوٹیفیکیشن ہے جسے Lix.li کسی ایونٹ کے پیش آنے پر خود بخود آپ کے سرور پر بھیجتا ہے۔ آپ کو کسی بھی API کو پول کرنے کی ضرورت نہیں — لنک پر کلک ہوتے ہی ڈیٹا خود بخود پہنچ جاتا ہے۔
آپ کے شارٹ لنکس پر ہونے والے کلکس۔ ایونٹس بیچز میں آتے ہیں (event_type = redirects.batch)؛ ہر کلک کے ساتھ وقت، ملک، شہر، OS، ڈیوائس، براؤزر، ریفرر اور بوٹ فلیگ بھیجا جاتا ہے۔
HTTP POST کے ذریعے JSON۔ باڈی میں کچھ میٹا فیلڈز (delivery_id، ٹائم ونڈو، count) اور ہر کلک کا ڈیٹا رکھنے والا events اری شامل ہوتا ہے۔ اس صفحے پر مکمل ریکویسٹ باڈی کی مثال موجود ہے۔
ہر ریکویسٹ آپ کے سیکرٹ کی کی بنیاد پر HMAC سے سائن ہوتی ہے — ہیڈر کا دستخط ریکویسٹ باڈی سے ملا کر جعلی ریکویسٹس کو فلٹر کیا جا سکتا ہے۔ سیکرٹ کو کسی بھی وقت دوبارہ جنریٹ (روٹیٹ) کیا جا سکتا ہے۔
ڈیلیوری خود بخود دوبارہ کوشش کرتی ہے۔ اگر endpoint طویل عرصے تک جواب نہ دے تو وہ عارضی طور پر غیر فعال ہو جاتا ہے، اور تمام کوششیں اور ان کی حیثیت ڈیلیوری لاگ میں محفوظ رہتی ہیں — کوئی ایونٹ خاموشی سے ضائع نہیں ہوتا۔
جی ہاں۔ دائرہ کار منتخب کیا جا سکتا ہے: اکاؤنٹ کے تمام لنکس، کسی مخصوص گروپ کے لنکس، یا صرف ایک لنک۔ اس طرح آپ کے سرور پر غیر ضروری ٹریفک نہیں آتا۔
ڈیفالٹ کے طور پر نہیں — کیونکہ یہ ذاتی ڈیٹا ہے۔ IP صرف اسی صورت ایونٹس میں شامل ہوتا ہے جب آپ اسے متعلقہ endpoint کی سیٹنگز میں واضح طور پر فعال کریں۔
Webhooks صرف Premium پلان میں دستیاب ہیں۔ اپنا endpoint جوڑنے کے لیے سائن اپ کریں اور Premium لیں۔

کلک ایونٹس کی بنیاد پر اپنی انٹیگریشنز بنائیں

چند منٹوں میں Webhook سیٹ کریں — اور کلک کا ڈیٹا بالکل وہیں پائیں جہاں آپ کو چاہیے۔

Lix.li کے webhooks آپ کے شارٹ لنکس پر کلک نوٹیفیکیشنز خود بخود حاصل کرنے کا ایک طریقہ ہیں۔ بار بار API پول کرنے کے بجائے، آپ صرف اپنے سرور کا URL دیتے ہیں، اور Lix.li کلک ہوتے ہی وہاں HTTP POST بھیج دیتا ہے۔ یہ شارٹ لنکس کے لیے ایک روایتی HTTP callback ہے، جو کلک ایونٹس کو ریئل ٹائم میں آپ کے سسٹم تک پہنچاتا ہے۔

ہر ریکویسٹ باڈی ایک redirects.batch ایونٹ ہوتی ہے جس میں کلکس کی ایک اری شامل ہوتی ہے: ہر کلک کے ساتھ وقت، ملک، شہر، براؤزر، آپریٹنگ سسٹم، ڈیوائس، ریفرر اور بوٹ فلیگ ہوتا ہے۔ اس ڈیٹا کو اپنے ڈیٹابیس یا CRM میں محفوظ کرنا، Telegram، Slack یا Discord میں کلک نوٹیفیکیشنز بنانا، یا Zapier، Make اور n8n میں ٹریگر کے طور پر استعمال کرنا آسان ہے۔ ریکویسٹس HMAC دستخط سے محفوظ ہوتی ہیں: آپ ہیڈر کا دستخط باڈی سے ملا کر جعلی ریکویسٹس کو فلٹر کرتے ہیں، اور ضرورت پڑنے پر سیکرٹ کو دوبارہ جنریٹ کر سکتے ہیں۔

ڈیلیوری پیش گوئی کے قابل ہے: سرور میں خرابی کی صورت میں ایونٹس دوبارہ بھیجے جاتے ہیں، مسلسل جواب نہ دینے والا endpoint عارضی طور پر غیر فعال ہو جاتا ہے، اور ہر کوشش ڈیلیوری لاگ میں نظر آتی ہے۔ دائرہ کار کو تمام لنکس، ایک گروپ، یا صرف ایک لنک تک محدود کیا جا سکتا ہے، اور اصل ٹریفک آنے سے پہلے ٹیسٹ بھیج کر (ping) انٹیگریشن کی تصدیق کی جا سکتی ہے۔ Webhooks عام Lix.li شارٹ لنکس، QR کوڈز اور شماریات کے ساتھ مل کر کام کرتے ہیں اور Premium پلان میں دستیاب ہیں۔

Webhook سیٹ کریں