मुख्य सामग्री पर जाएं
Node.js और TypeScript के लिए Didit की आधिकारिक लाइब्रेरी। यह Node.js 18 या उसके बाद के संस्करण, Bun, Deno और fetch वाले एज रनटाइम पर चलती है, ES module और CommonJS दोनों बिल्ड देती है, और इसकी कोई रनटाइम डिपेंडेंसी नहीं है। सभी SDK में साझा चीज़ों के लिए सर्वर SDK अवलोकन देखें।

इंस्टॉल

पैकेज npm पर @didit-protocol/sdk-node है। इसका सोर्स और चेंजलॉग GitHub पर didit-protocol/sdk-node में हैं।

क्लाइंट कॉन्फ़िगर करें

Node.js, Bun और Deno पर new Didit() एनवायरनमेंट से DIDIT_API_KEY पढ़ता है (Deno में --allow-env के साथ)। एज रनटाइम में कोई प्रोसेस एनवायरनमेंट नहीं होता, इसलिए वहाँ कुंजी एक विकल्प के रूप में दें: new Didit({ apiKey: env.DIDIT_API_KEY })। विकल्प देकर इसे ओवरराइड किया जा सकता है, या संगठन और एप्लिकेशन ID सेट किए जा सकते हैं, जो एप्लिकेशन-स्कोप वाले कॉल (केस, नेटवर्क, नियामक रिपोर्ट) के लिए ज़रूरी हैं। टाइमआउट मिलीसेकंड में है।
CommonJS के साथ const { Didit } = require("@didit-protocol/sdk-node"); का उपयोग करें।

सत्र बनाएँ

किसी वर्कफ़्लो के लिए एक सत्यापन सत्र बनाएँ और अपने उपयोगकर्ता को उसके URL पर भेजें। अनुरोध के फ़ील्ड API के अपने ही नाम रखते हैं।

निर्णय पढ़ें

जब उपयोगकर्ता अपना काम पूरा कर ले (या जब webhook आए), तब निर्णय पढ़ें। हर फ़ीचर का परिणाम एक सूची होता है, जिसमें वर्कफ़्लो के हर नोड के लिए एक एंट्री होती है, और दिनांक-समय Date ऑब्जेक्ट होते हैं।

webhook सत्यापित करें

कच्ची बॉडी (पार्स किया हुआ JSON नहीं) और अनुरोध हेडर पास करें: Node.js या Express का req.headers ऑब्जेक्ट, Fetch का Headers ऑब्जेक्ट, या [name, value] जोड़े (WebhookHeaders टाइप)। verify एक प्रॉमिस लौटाता है और किसी भी ऐसी डिलीवरी पर WebhookVerificationError के साथ reject करता है जो मान्य और ताज़ा न हो।
Express के साथ express.raw({ type: "application/json" }) से body पढ़ें और handleWebhook(req.body, req.headers) कॉल करें। सीक्रेट रोटेट करते समय दोनों पास करें: [newSecret, oldSecret]। इवेंट और हस्ताक्षर स्कीम के लिए Webhooks देखें।

लेन-देन की स्क्रीनिंग करें

भुगतान, निकासी या क्रिप्टो ट्रांसफ़र को लेन-देन निगरानी पर सबमिट करें; रिस्पॉन्स में उसकी स्थिति और जोखिम स्कोर होता है।

Authentication टोकन सत्यापित करें

Authentication आपके बैकएंड में, हर अनुरोध के लिए Didit को कॉल किए बिना, उन एक्सेस टोकन की जाँच करता है जिन्हें आपका Authentication जारीकर्ता साइन करता है। यह कोड का आदान-प्रदान करता है, टोकन रीफ़्रेश करता है, सत्रों की जाँच और उन्हें रद्द करता है, और स्टेप-अप चलाता है।
टोकन सत्यापन अपने सर्वर पर टोकन सत्यापित करें में दी गई जाँचें करता है, जो आपके एप्लिकेशन के जारीकर्ता और हस्ताक्षर कुंजियों के विरुद्ध होती हैं।

त्रुटियाँ

सूचियाँ और फ़ाइलें

API संदर्भ के सर्वर endpoint पेज में उनके ऑपरेशन का Node.js नमूना होता है, सिवाय उन endpoints और फ़ील्ड के जो अभी किसी 1.0.1 रिलीज़ में नहीं हैं, जिन्हें अवलोकन में नाम दिया गया है।
अंतिम संशोधन 7 नवंबर 2026