Network operations staffed around the clock
Skyroute
EN · EnglishEN
Talk to salesRequest access
डेवलपर / वेबहुक

प्राप्त घटना की पुष्टि करें।

Skyroute हर आउटबाउंड वेबहुक पर उस एंडपॉइंट के रहस्य से हस्ताक्षर करता है। कॉल घटना को विश्वसनीय मानने से पहले मूल अनुरोध सत्यापित करें।

आउटबाउंड घटना डिलीवरी

हस्ताक्षरित अनुरोध, स्पष्ट सीमा।

खाता सेटिंग में वेबहुक बनाएँ और दिखने पर उसका हस्ताक्षर रहस्य सुरक्षित रखें। यह रहस्य संग्रहीत स्थिति में एन्क्रिप्ट होता है, HTTP पेलोड में नहीं भेजा जाता, और एक बार फिर दिखाने के लिए बदला जा सकता है।

01 / डिलीवरी प्रारूप

जिन बाइट पर हस्ताक्षर होते हैं।

Skyroute कॉन्फ़िगर किए गए सार्वजनिक HTTPS URL पर JSON के साथ POST करता है: event and payload. X-Skyroute-Timestamp सेकंड में Unix टाइमस्टैम्प है। X-Skyroute-Signature का प्रारूप है v1=<lowercase hex>। हस्ताक्षर इस इनपुट का HMAC-SHA256 है: timestamp + "." + raw JSON body.

घटना बॉडी · उदाहरण
{"event":"call.started","payload":{"id":42,"status":"ringing"}}
हस्ताक्षर इनपुट
HMAC_SHA256(secret, timestamp + "." + raw_body)
02 / प्रसंस्करण से पहले सत्यापित करें

मूल बॉडी अपरिवर्तित रखें।

JSON पार्स करने से पहले अनुरोध की बाइट पढ़ें। छोटी सहनशीलता अवधि से बाहर के टाइमस्टैम्प अस्वीकार करें, एंडपॉइंट रहस्य से HMAC बनाएँ और प्राप्त डाइजेस्ट की स्थिर समय में तुलना करें। उदाहरण पाँच मिनट की सहनशीलता इस्तेमाल करता है; दोहराए गए अनुरोध रोकने के लिए घटना ID या समकक्ष कुंजी सहेजें।

NODE.JS · सत्यापन उदाहरण
import { createHmac, timingSafeEqual } from 'node:crypto';

function verifySkyroute(rawBody, timestamp, signature, secret) {
  if (!/^\d+$/.test(timestamp ?? '')) return false;
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
  const supplied = signature?.startsWith('v1=') ? signature.slice(3) : '';
  if (!/^[a-f0-9]{64}$/.test(supplied)) return false;
  const expected = createHmac('sha256', secret)
    .update(`${timestamp}.`)
    .update(rawBody)
    .digest();
  return timingSafeEqual(expected, Buffer.from(supplied, 'hex'));
}

// In Express, use express.raw({ type: 'application/json' })
// on this route, then pass req.body to verifySkyroute.
// Parse JSON only after verification succeeds.

मिली हुई बाइट ज्यों की त्यों इस्तेमाल करें। JSON को पार्स करके दोबारा लिखने से हस्ताक्षर इनपुट बदल जाता है।

03 / रहस्य बदलना

दिखते ही सुरक्षित रखें।

वेबहुक बनाने या उसका रहस्य बदलने के बाद हस्ताक्षर रहस्य केवल एक बार दिखता है। बदलाव पर अपने रिसीवर को तुरंत अद्यतन करें; पुराना रहस्य नई डिलीवरी पर हस्ताक्षर नहीं करेगा। सहेजे न गए रहस्य वाले वेबहुक का रहस्य वेबहुक सेटिंग में बदला जा सकता है।

आवश्यक हेडर
Content-Type: application/json
X-Skyroute-Timestamp: 1793490000
X-Skyroute-Signature: v1=<64 lowercase hex characters>
04 / वर्तमान डिलीवरी व्यवहार

संचालन सीमा जानें।

Most events make one outbound HTTPS attempt per matching active webhook, with a five-second timeout and redirects disabled; failed attempts are logged without automatic retry. Sandbox route_test.result events are an exception: they use a durable retry queue and may arrive more than once. Deduplicate those events using the stable X-Skyroute-Event-Id header or payload.delivery_id. The separate inbound endpoint POST /api/webhooks/events प्रदाता-विशिष्ट हस्ताक्षर सत्यापक कॉन्फ़िगर होने तक 503 लौटाता है।