Webhooks

Webhook आपके सर्वर पर एक पता है जिसे Posty5 कुछ होने पर कॉल करता है। Posty5 से नई विज़िट पूछने के बजाय, आपके सिस्टम को कुछ ही सेकंड में एक JSON इवेंट के साथ बताया जाता है जिसे वह सत्यापित कर सकता है।

टिप्पणी

Webhooks आपके प्लान पर निर्भर करते हैं। डिलीवरी में कोई क्रेडिट नहीं लगता। विवरण के लिए क्रेडिट पेज देखें। फ़ीचर क्रेडिट

एक एंडपॉइंट बनाएँ

1. Posty5 डैशबोर्ड में खाता सेटिंग्स खोलें और Webhooks चुनें।

2. एक एंडपॉइंट जोड़ें, उसका HTTPS पता दर्ज करें और वे इवेंट चुनें जो उसे मिलेंगे।

3. अपने सभी लिंक और QR कोड चुनें या केवल कुछ, बॉट विज़िट गिनी जाएँ या नहीं, और इवेंट एक-एक करके आएँ या बैच में।

4. सहेजें, फिर साइनिंग सीक्रेट कॉपी करें। यह केवल इसी एक बार दिखाया जाता है।

5. टेस्ट भेजें का उपयोग करके जाँचें कि आपका सर्वर webhook.test इवेंट प्राप्त और सत्यापित करता है।

पता HTTPS का उपयोग करे और इंटरनेट से पहुँच योग्य हो। निजी और लोकल नेटवर्क पते अस्वीकार किए जाते हैं, और रीडायरेक्ट का पालन नहीं होता। आपके पास अधिकतम 10 एंडपॉइंट हो सकते हैं।

इवेंट

Event
short_link.visited	किसी ने आपका कोई शॉर्ट लिंक खोला, लिंक की QR इमेज के ज़रिए भी।
short_link.visits_milestone	किसी शॉर्ट लिंक ने आपकी तय की गई विज़िट संख्याओं में से एक को छू लिया (अधिकतम 10 मान)।
qr_code.scanned	किसी ने आपका कोई डायनेमिक QR कोड स्कैन किया।
qr_code.scans_milestone	किसी QR कोड ने आपकी तय की गई स्कैन संख्याओं में से एक को छू लिया।
webhook.test	केवल तब भेजा जाता है जब आप टेस्ट भेजें का उपयोग करते हैं।

विज़िट और स्कैन इवेंट अभी नहीं भेजे जाते

अभी Posty5 केवल टेस्ट इवेंट भेजता है। विज़िट और स्कैन इवेंट, और उनके माइलस्टोन, विज़िट एनालिटिक्स जारी होने पर शुरू होंगे। आप अभी एंडपॉइंट बना और टेस्ट कर सकते हैं, और तब वे बिना किसी बदलाव के वे इवेंट पाने लगेंगे।

स्टैटिक QR कोड कोई इवेंट नहीं भेजते

स्टैटिक QR कोड अपनी सामग्री सीधे रखता है, इसलिए स्कैन कभी Posty5 तक नहीं पहुँचता और कोई इवेंट नहीं भेजा जा सकता। केवल डायनेमिक QR कोड और शॉर्ट लिंक इवेंट बनाते हैं।

इवेंट कैसा दिखता है

हर इवेंट एक JSON POST है जिसमें id, type, API संस्करण, बनने का समय और उसका डेटा होता है, यानी लिंक या QR कोड और विज़िट।

{
  "id": "evt_6700f1c2a9e4b51d2c3f0a11",
  "type": "short_link.visited",
  "apiVersion": "2026-10-01",
  "createdAt": "2026-10-04T12:00:00.000Z",
  "data": {
    "target": {
      "type": "shortLink",
      "id": "66f0c2a9e4b51d2c3f0a1122",
      "code": "aB3xY9",
      "url": "https://pst5.com/_aB3xY9",
      "name": "Spring sale",
      "destinationUrl": "https://shop.example/sale",
      "tag": "spring",
      "refId": null
    },
    "visit": {
      "at": "2026-10-04T11:59:59.120Z",
      "channel": "qr",
      "country": "EG",
      "deviceType": "mobile",
      "os": "Android",
      "browser": "Chrome",
      "referrerHost": null,
      "language": "ar",
      "isBot": false,
      "outcome": "redirect"
    }
  }
}

माइलस्टोन इवेंट में data.milestone होता है जिसमें मेट्रिक, पहुँचा गया मान और कब पहुँचा, शामिल हैं, और कोई विज़िट नहीं।

बैच डिलीवरी में, batch प्रकार का एक POST data.events में अधिकतम 500 इवेंट ले जाता है।

क्या कभी नहीं भेजा जाता

इवेंट में कभी विज़िटर का IP पता, पूरा यूज़र एजेंट, पूरा रेफ़रर पता, विज़िटर पहचानकर्ता या आपकी खाता ID नहीं होती। बॉट विज़िट तब तक छोड़ी जाती हैं जब तक आप उन्हें शामिल न करें।

हस्ताक्षर सत्यापित करें

Posty5 हर डिलीवरी पर Standard Webhooks विनिर्देश के अनुसार आपके एंडपॉइंट के सीक्रेट से तीन हेडर में हस्ताक्षर करता है। ऐसा कोई भी अनुरोध अस्वीकार करें जिसका हस्ताक्षर मेल न खाए या जिसका टाइमस्टैम्प 5 मिनट से पुराना हो।

• webhook-id
• webhook-timestamp
• webhook-signature

Node.js में @posty5/webhooks पैकेज का उपयोग करें।

import { verifyWebhookSignature } from "@posty5/webhooks";

// rawBody is the request body exactly as received, before JSON parsing.
const event = verifyWebhookSignature({
  payload: rawBody,
  headers: request.headers,
  secret: process.env.POSTY5_WEBHOOK_SECRET,
});

.NET में Posty5.Webhooks पैकेज का उपयोग करें।

using Posty5.Webhooks;

var webhookEvent = WebhookSignature.Verify(rawBody, headers, secret);

किसी भी दूसरी भाषा में, कोई भी Standard Webhooks लाइब्रेरी आपके सीक्रेट से Posty5 इवेंट सत्यापित करती है।

सावधानी

बॉडी को ठीक वैसे ही सत्यापित करें जैसी वह मिली थी। JSON को पार्स करके फिर से सीरियलाइज़ करने से बाइट बदल जाते हैं और हस्ताक्षर टूट जाता है।

पुनः प्रयास और विफलताएँ

• 10 सेकंड के अंदर किसी भी 2xx स्थिति के साथ जवाब दें। बाकी सब विफलता माना जाता है।
• विफल डिलीवरी को 30 सेकंड, 2 मिनट, 10 मिनट, 1 घंटे, 6 घंटे और 24 घंटे बाद दोबारा भेजा जाता है, फिर छोड़ दिया जाता है।
• हर पुनः प्रयास में वही webhook-id होती है, ताकि आपका सर्वर पहले से संभाले गए इवेंट को अनदेखा कर सके।
• कम से कम 24 घंटों में लगातार 20 विफल डिलीवरी के बाद, या 410 Gone जवाब मिलने पर तुरंत, एंडपॉइंट बंद कर दिया जाता है। आपको एक सूचना मिलती है, और आप उसे डैशबोर्ड से फिर चालू कर सकते हैं।
• एंडपॉइंट की डिलीवरी सूची हर प्रयास को उसकी स्थिति और आपके सर्वर के जवाब के साथ दिखाती है, और आपको डिलीवरी फिर से भेजने देती है।

सीक्रेट बदलें

अगर सीक्रेट लीक हुआ हो सकता है, तो उसे एंडपॉइंट के मेनू से बदलें। 24 घंटे तक डिलीवरी में दो हस्ताक्षर होते हैं, हर सीक्रेट का एक, ताकि आप इवेंट खोए बिना अपना सर्वर अपडेट कर सकें।

बिना कोड के, n8n में

Posty5 Trigger नोड आपके लिए एंडपॉइंट बनाता और सत्यापित करता है। n8n Posty5 Trigger