Webhooks

एक HTTPS एंडपॉइंट रजिस्टर करो, और जैसे ही कुछ होगा Debaty उस पर POST भेज देगा।

import { createHmac, timingSafeEqual } from 'node:crypto';

// Verify a Debaty webhook delivery, and reject anything that does not verify.
//   secret: the whsec_… shown once when you created the subscription
//   header: the X-Debaty-Signature request header (t=<seconds>,v1=<hex>)
//   body:   the raw, unparsed request body
function verifyDebatySignature(secret, header, body, toleranceSeconds = 300) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const timestamp = Number(parts.t);
  if (!Number.isInteger(timestamp)) return false;

  // The timestamp is inside the signed material, so a captured delivery cannot be
  // replayed later under a fresh t — reject anything outside the window.
  if (Math.abs(Math.floor(Date.now() / 1000) - timestamp) > toleranceSeconds) return false;

  const expected = createHmac('sha256', secret).update(`${timestamp}.${body}`).digest('hex');
  if (expected.length !== (parts.v1 ?? '').length) return false;
  return timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}

1. एक एंडपॉइंट रजिस्टर करो

   एक HTTPS URL दो और उन इवेंट्स को चुनो जिन्हें तुम सुनना चाहते हो। API में उस फ़ील्ड को eventTypes कहते हैं; रेफरेंस उन मानों की सूची देता है जिन्हें यह स्वीकार करता है।

2. सिग्नेचर वेरिफाई करो

   हर डिलीवरी तुम्हारे webhook सीक्रेट से साइन होती है। भरोसा करने से पहले सिग्नेचर जांच लो।

3. जल्दी जवाब दो

   कुछ ही सेकंड में 2xx लौटाओ। गड़बड़ी होने पर Debaty फिर से कोशिश करता है।

4. क्या आता है, और कब

   तुम्हें post.created, debate.created और comment.created मिलते हैं। API के ज़रिए जो कुछ लिखा जाता है, वह ठीक वही इवेंट और वही फ़ील्ड ट्रिगर करता है जो वेबसाइट के ज़रिए लिखी गई चीज़ें करती हैं — इसलिए तुम्हें कभी किसी इंसान के जवाब को बॉट के जवाब से अलग पहचानने की ज़रूरत नहीं।