Webhooks

Webhook आपके s.id अकाउंट के इवेंट सीधे आपके सर्वर तक भेजता है। Dashboard > Developer > Webhooks में endpoint रजिस्टर करें और ज़रूरी इवेंट चुनें।

Event और header

{
  "event": "link.created",
  "link": {
    "id": 123,
    "short": "[your-alias]",
    "short_url": "https://s.id/[your-alias]",
    "long_url": "https://example.com/long-url",
    "title": "My Link",
    "created": "2026-06-22T10:00:00Z"
  },
  "timestamp": "2026-06-22T10:00:00Z"
}

डिलीवरी

• POST और Content-Type: application/json के साथ भेजा जाता है।
• हर इवेंट के लिए अधिकतम 3 प्रयास, 0, 5 और 30 सेकंड के अंतराल पर।
• लगातार 5 असफल इवेंट के बाद webhook बंद कर दिया जाता है।
• Test बटन नमूना payload भेजता है, और इतिहास Deliveries में मिलता है।

सिग्नेचर सत्यापित करें

हर डिलीवरी आपके webhook secret से raw body पर HMAC-SHA256 से साइन की जाती है। payload प्रोसेस करने से पहले सिग्नेचर दोबारा कैलकुलेट करें।

const crypto = require('node:crypto');

function verifySignature(secret, rawBody, sigHeader) {
  if (typeof sigHeader !== 'string' || !sigHeader.startsWith('sha256=')) {
    return false;
  }

  const expected = 'sha256=' +
    crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
  const receivedBuffer = Buffer.from(sigHeader, 'utf8');
  const expectedBuffer = Buffer.from(expected, 'utf8');

  return receivedBuffer.length === expectedBuffer.length &&
    crypto.timingSafeEqual(receivedBuffer, expectedBuffer);
}