> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Didit इंटीग्रेशन: API, SDK और Webhooks

> Didit के डेवलपर इंटीग्रेशन का वीडियो ट्रांसक्रिप्ट: session API, SDKs, webhooks और sandbox से production तक जाने का तरीका।

[अपने ऐप में Didit इंटीग्रेट करें: API, SDK और Webhooks (डेवलपर गाइड)](https://www.youtube.com/embed/fX03-WEu_EI)

**Integrate Didit in Your App: API, SDK and Webhooks (Developer Guide)** का पूरा ट्रांसक्रिप्ट - Didit Academy वीडियो 8 में से 10, 08:13। [YouTube पर देखें](https://www.youtube.com/watch?v=fX03-WEu_EI)। हर अनुच्छेद वीडियो के ठीक उस क्षण से लिंक है।

## आप क्या जोड़ेंगे

[00:04](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=4s) इस वीडियो में आप Didit को अपनी ही ऐप से जोड़ेंगे। इससे आपके उपयोगकर्ता आपके प्रोडक्ट के भीतर ही सत्यापन करेंगे, और हर परिणाम घटित होते ही आपके सिस्टम तक पहुँच जाएगा। यह डेवलपर्स वाला वीडियो है, इसलिए यह थोड़ा अधिक तकनीकी है, लेकिन जितना आप सोचते हैं उससे सरल है। और अंत तक आप देखेंगे कि ज़्यादातर काम आप सीधे cloud code को सौंप सकते हैं, और वह उसे आपके लिए बना देगा। तो हम इसे उसी क्रम में देखेंगे

## SDK, API और webhook: तीन हिस्से

[00:28](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=28s) जिस क्रम में आप इसे असल में बनाएँगे। चलिए सीधे शुरू करते हैं। Didit को इंटीग्रेट करने का मतलब है तीन चीज़ें जोड़ना। SDK आपकी ऐप के भीतर ही कैमरा, दस्तावेज़ कैप्चर, NFC रीड और लाइवनेस UI को रेंडर करता है। API सर्वर-से-सर्वर है, इसलिए आपका बैक एंड सत्र बनाता है और प्रामाणिक निर्णय पढ़ता है। और webhook, सत्र की स्थिति बदलते ही आपके HTTPS endpoint को कॉल करता है। यह polling के मुकाबले

## Integrate टैब

[00:56](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=56s) कहीं तेज़ और अधिक समृद्ध है। इसलिए इंटीग्रेट करने का सबसे आसान तरीका है कि आप अपने Manage टैब पर जाएँ, Integrate पर क्लिक करें, और वहाँ से सारी सेटिंग्स ले लें। हम अपनी API कुंजी ले सकते हैं। हम इस खास ऐप के लिए एक अलग API कुंजी भी सेट कर सकते हैं जिस पर हम अभी काम कर रहे हैं। हम वह वर्कफ़्लो बना और चुन सकते हैं जिसे हम इंटीग्रेट करना चाहते हैं। हम एक webhook जोड़ सकते हैं। यही वह जगह है जहाँ सत्यापन परिणाम भेजे जाते हैं।

[01:24](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=84s) और साइनिंग सीक्रेट, जिसे मैं अभी एक सेकंड में दिखाऊँगा, यही वह चीज़ है जो

## अपना प्लेटफ़ॉर्म चुनना

[01:28](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=88s) अपनी ENV फ़ाइल में जाएगी। फिर आप इसे अपनी ऐप से कनेक्ट कर सकते हैं। यहाँ हमारे पास कई अलग विकल्प हैं: web JS, React Native, iOS, Android, Flutter, और कुछ अन्य प्लेटफ़ॉर्म। तो आप अपनी ऐप के लिए जो प्रासंगिक हो, वह चुन सकते हैं। ये वे एनवायरनमेंट सीक्रेट्स हैं जिन्हें आप अपनी ENV फ़ाइल में डालेंगे, जो आपके

## AI सेटअप प्रॉम्प्ट

[01:48](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=108s) सर्वर पर है। इसे सेट करने का आसान तरीका है AI setup prompt इस्तेमाल करना। हम यहाँ ऊपर सारी सेटिंग्स कॉन्फ़िगर करते हैं, फिर prompt कॉपी करते हैं, और वह यहाँ पूरी की गई सेटिंग से हमें ज़रूरी सारी जानकारी कॉपी कर देगा। इसे कॉपी करके Cloud Code या Codex में, या जहाँ भी आप अपनी ऐप बना रहे हों, पेस्ट कर सकते हैं।

## API कुंजियाँ, प्रति एनवायरनमेंट एक

[02:09](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=129s) आपकी API कुंजियाँ यहाँ रहती हैं, और हर पंक्ति में एक कुंजी होती है, ठीक है? इसलिए एक अच्छी आदत है प्रति एनवायरनमेंट और प्रति इंटीग्रेशन अलग कुंजी रखना, ताकि आप किसी एक को रोटेट या निरस्त कर सकें, बिना बाकियों को तोड़े। तो अगर आप किसी खास वर्कफ़्लो को इंटीग्रेट करने जा रहे हैं, तो

## कुंजी बनाना

[02:27](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=147s) हो सकता है आप उस वर्कफ़्लो के लिए अलग API कुंजी रखना चाहें, उदाहरण के लिए। अब, अगर मैं create API key पर क्लिक करता हूँ, उम, तो मैं बस यहाँ test लिखूँगा, और API कुंजी बना दूँगा। अब मैं इसे कॉपी कर सकता हूँ, है ना? और यह मैं दोबारा नहीं देख पाऊँगा। इसलिए ज़रूरी है कि आप इसे कॉपी करें और कहीं नोट कर लें, ताकि इंटीग्रेशन के समय इसका उपयोग कर सकें। जब आप इंटीग्रेशन सेक्शन में आते हैं और अपनी API कुंजी लेते हैं, और मान लीजिए मैं test कुंजी लेकर नीचे आता हूँ और चुनता हूँ, ठीक है, देखते हैं, हम इसे KYC वर्कफ़्लो के लिए इस्तेमाल करना चाहते हैं। हम एक webhook जोड़ सकते हैं।

[03:05](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=185s) हम अपनी ऐप कनेक्ट कर सकते हैं, ठीक है। और फिर यहाँ यह setup प्रॉम्प्ट डाल सकते हैं। आप यहाँ देख सकते हैं कि यह प्रॉम्प्ट

## Webhooks का अवलोकन

[03:13](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=193s) API कुंजी शामिल करेगा। तो अब webhook पर जल्दी से आते हैं: हम लगभग किसी भी चीज़ के लिए webhook सेट कर सकते हैं। मान लीजिए आप किसी खास इवेंट को Slack पर भेजना चाहते हैं, ठीक है? हम

## दस्तावेज़ीकरण

[03:25](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=205s) webhook URL यहाँ जोड़ सकते हैं। ठीक है, तो चलिए दस्तावेज़ीकरण पर एक नज़र डालते हैं, क्योंकि आपके पास सारा तकनीकी दस्तावेज़ीकरण उपलब्ध है। बस docs.didit.me पर जाइए, और हम यहाँ कुछ चीज़ें देखेंगे

## Create session: एकमात्र अनिवार्य फ़ील्ड

[03:37](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=217s) यहाँ देखिए। सब कुछ create session के आसपास घूमता है। ठीक है, तो यह एक POST अनुरोध है, और यह एक सत्यापन की शुरुआत है। curl अनुरोध में हम देख सकते हैं कि वर्कफ़्लो ID है। यही एकमात्र अनिवार्य फ़ील्ड है, और सबसे उपयोगी बात यह है कि यही एक endpoint KYC और KYB, दोनों सत्र बनाता है। कौन-सा बनेगा, यह

## Vendor data और कॉलबैक URL

[04:00](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=240s) वर्कफ़्लो तय करता है। यहाँ नीचे हमारे पास कुछ अतिरिक्त फ़ील्ड्स हैं, जिनमें vendor data शामिल है, जिसकी इन वीडियो में हम काफ़ी चर्चा कर चुके हैं। यह हर उपयोगकर्ता का अनोखा पहचानकर्ता है, और आप इसे अपनी इच्छानुसार परिभाषित कर सकते हैं, चाहे यह ईमेल हो या कोई अनोखा पहचानकर्ता। और यहाँ हमारे पास कॉलबैक URL है। यहीं पर उपयोगकर्ता को भेजा जाएगा, जब वह सत्यापन वर्कफ़्लो पूरा कर लेगा। तो

## endpoint को लाइव आज़माना

[04:24](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=264s) अगर हम नीचे स्क्रॉल करें, तो इसे सच में आज़मा सकते हैं। अगर हम try it पर क्लिक करते हैं, तो यहीं एक सत्यापन सत्र बना सकते हैं। मैं बस एक API कुंजी यहाँ डालने वाला हूँ। एक नई बनाता हूँ, test two। उसे कॉपी करता हूँ और यहाँ डालता हूँ। हमें एक वर्कफ़्लो ID चाहिए, तो उधर चलते हैं। यहाँ से यह वर्कफ़्लो ID ले सकते हैं और उसे वहाँ डालें। vendor data आवश्यक नहीं है। चलिए एक यादृच्छिक संख्या-स्ट्रिंग डालते हैं।

[05:02](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=302s) कॉलबैक को हम वैसा ही रख सकते हैं। वैसे, इनमें से कुछ भी आवश्यक नहीं है। मुझे लगता है ऐसा इसलिए है क्योंकि यहाँ मेरे पास एक test account है, लेकिन अगर आप इस endpoint को टेस्ट करना चाहते हैं, तो ठीक ऐसे ही टेस्ट करेंगे। अब, अगर आप डेवलपर हैं और यहाँ आपको खास जवाब चाहिए, तो आप दस्तावेज़ीकरण देख सकते हैं। MCP की पहुँच भी इस पूरे दस्तावेज़ीकरण तक है, इसलिए आप बस MCP को इंटीग्रेट करके Claude से वह तकनीकी सवाल पूछ सकते हैं जो शायद इन दस्तावेज़ों में मिल जाएगा।

## webhook: पोलिंग क्यों नहीं

[05:32](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=332s) इसके अंदर। तो, चलिए webhooks के बारे में बात करते हैं। मैनेज सेक्शन में webhooks के लिए एक टैब है, और इसी से आपके नतीजे असल में आप तक पहुँचते हैं। Webhooks अनुशंसित चैनल हैं, क्योंकि पोलिंग काफ़ी धीमी है, और

## डेस्टिनेशन जोड़ना और इवेंट चुनना

[05:44](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=344s) इससे आपको ज़्यादा अनुरोध करने पड़ेंगे, और कुछ इवेंट छूट जाएँगे। इसलिए हम यहाँ एक नया webhook गंतव्य जोड़ते हैं। हम एक URL पेस्ट कर सकते हैं और अपनी इच्छानुसार इवेंट चुन सकते हैं। यह वह सारा डेटा है जिसे हम इस विशेष endpoint पर भेजना चाहते हैं। Diddy आपको एक बार इस्तेमाल किया जाने वाला साइनिंग सीक्रेट देगा, जिसे मैं एक सेकंड में दिखाऊँगा। URL सीधे पहुँच योग्य होना चाहिए: localhost और निजी IP पते स्वीकार्य नहीं हैं। अब मैं यहाँ से बाहर निकलता हूँ; दाईं ओर स्क्रॉल करने पर हमें कुछ विकल्प दिखाई देते हैं।

[06:16](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=376s) तो यहाँ हम देख सकते हैं कि यह webhook कितने इवेंट सुन रहा है, और हम

## साइनिंग सीक्रेट

[06:19](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=379s) साइनिंग सीक्रेट कॉपी कर सकते हैं, जो आपके इंटीग्रेशन के लिए ज़रूरी होगा। अब, जब हम इंटीग्रेशन टैब में इंटीग्रेशन सेटअप करते हैं, जिसके बारे में मैंने आपको बताया था, और उसमें एक प्रॉम्प्ट है, तो सेटअप में चुने गए webhook का साइनिंग सीक्रेट यहीं होगा। तो,

## webhook हैंडलर प्रॉम्प्ट

[06:34](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=394s) AI का इस्तेमाल करने का एक और तरीका, हमारे पास webhooks टैब में मिला एक तैयार प्रॉम्प्ट है। अगर आप अपना webhook हैंडलर AI से सेट अप करवाना चाहते हैं, तो हम इसे देख सकते हैं। हम documentation देख सकते हैं और वहाँ एक इंटीग्रेशन प्रॉम्प्ट पा सकते हैं। यह पहचान सत्यापन, इकाइयों और लेन-देन को कवर करेगा। यह आपके लिए सब कुछ बना देगा। तो यह सब कुछ स्पष्ट रूप से बताता है: क्या बनाना है, सत्यापन के हस्ताक्षर हेडर, वे webhook इवेंट टाइप जो हमने webhook सेट अप करते समय देखे थे। इसमें webhook envelope और इसके अलावा भी बहुत कुछ है, और हम यह भी चुन सकते हैं कि इसे किस टूल में पेस्ट करना है, जिसे हम यहाँ इस्तेमाल कर रहे हैं।

[07:15](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=435s) तो अगर आप यह प्रॉम्प्ट इस्तेमाल करना चाहते हैं, तो इसे शुरू करने और इंटीग्रेशन सेट अप करने का यह सबसे आसान तरीका है। इस वीडियो में मैंने अभी जो कुछ भी बताया, वह अगर आप MCP server इंटीग्रेट करते हैं, तो आपके AI टूल के अंदर उपलब्ध है और उस पर क्वेरी की जा सकती है। तो आप सादी अंग्रेज़ी में बस बता सकते हैं कि आप क्या चाहते हैं, और Cloud Code documentation पढ़ेगा और आपके लिए इंटीग्रेशन बना देगा। तो आप बस काम की जाँच कर रहे होंगे, यह सुनिश्चित करते हुए कि यह चल रहा है और

## सारांश

[07:41](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=461s) काम कर रहा है, बजाय इसके कि सब कुछ शुरू से कोड करें। तो, यही है आपके ऐप में Didit। SDK, जिसे आपके उपयोगकर्ता देखते हैं, API, जिसे आपका बैक एंड कॉल करता है, और साइन किया हुआ webhook, जो वह निर्णय भेजता है जिसके आधार पर आप आगे काम करते हैं। webhook पर भरोसा करें, हर जगह वेंडर डेटा इस्तेमाल करें, और सेटअप प्रॉम्प्ट का सहारा लें, ताकि आपको उबाऊ हिस्से हाथ से न जोड़ने पड़ें। आप didit.me पर जा सकते हैं, मुफ़्त में साइन अप कर सकते हैं, और कुछ ही मिनटों में एक सत्यापन चला सकते हैं।


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.