API key डेवलपर्स, API कीज़ में है; workflow ID वर्कफ़्लो पेज पर; और webhook signing secret हर endpoint के लिए डेवलपर्स, वेबहुक में अलग है।

संक्षिप्त उत्तर

आपको console से तीन values चाहिए. API key डेवलपर्स → API कीज़ में बनती है. Workflow ID वर्कफ़्लो पेज से कॉपी होती है. Webhook signing secret हर endpoint का अपना होता है, डेवलपर्स → वेबहुक में, और आप उसे दिखाएँ से कभी भी दोबारा देख सकते हैं. तीनों एक ही application और एक ही environment (Live या Sandbox) से लें.

Starter app या AI से बने project में अक्सर DIDIT_API_KEY, DIDIT_WORKFLOW_ID और DIDIT_WEBHOOK_SECRET जैसे environment variables लिखे होते हैं. ये नाम उस app के हैं: Didit इन्हें आपके लिए सेट नहीं करता. यह table बताती है कि हर value कहां से आती है.

#हर value कहां मिलती है

Valueकहां से लेंक्या ध्यान रखें
API keyडेवलपर्स → API कीज़, फिर कुंजी बनाएँ (हर application की एक प्राथमिक key भी होती है)पूरा secret सिर्फ़ एक बार दिखता है, key बनाते या rotate करते समय, इसलिए तभी उसे अपने secret manager में कॉपी करें. Live application और Sandbox application की keys अलग हैं: sandbox key कभी live verification नहीं बनाती. उसे x-api-key header में भेजें, सिर्फ़ अपने server से
Workflow IDपहचान सत्यापन → वर्कफ़्लो: row का menu खोलकर वर्कफ़्लो ID कॉपी करें चुनें (preview panel में भी यही button है)हर application में हर workflow की अपनी ID होती है. Workflow की copy को नई ID मिलती है
Webhook signing secretडेवलपर्स → वेबहुक, endpoint खोलें, फिर उसका signing secret और दिखाएँ दबाएंहर endpoint का एक secret, हर application का नहीं. दिखाएँ आपसे पुष्टि मांगता है कि यह आप हैं, फिर secret 60 सेकंड के भीतर फिर छिप जाता है. आप उसे जब चाहें दोबारा दिखा सकते हैं
API base URLConsole में नहीं: docs.didit.me में लिखा हैhttps://verification.didit.me verification API (sessions, workflows, lists, webhooks) चलाता है, जो x-api-key header से authenticate होती है. देखें API authentication
नोट

API key और signing secret अलग values हैं. API key Didit को आपके calls authenticate करती है; signing secret आपको जांचने देता है कि कोई webhook सच में Didit से आया है. एक की जगह दूसरी इस्तेमाल करने पर 401 या signature mismatch मिलता है.

#क्या मैं webhook signing secret दोबारा देख सकता हूं?

हां. डेवलपर्स → वेबहुक खोलें, endpoint खोलें और दिखाएँ दबाएं. पुष्टि करें कि यह आप हैं, और secret 60 सेकंड तक दिखता है. अगर आपके लिए दिखाएँ धूसर है, तो अपने किसी ऐसे टीममेट से कहें जिसके पास access है या support से संपर्क करें. अगर आपको नया secret चाहिए, तो उसे rotate करें: पुराना 24 घंटे तक काम करता रहता है. और जानकारी webhooks से verification नतीजे पाना में है.

#अपना setup जांचें

  1. Environment मिलाएं

    पहले console में application और Live या Sandbox environment चुनें, फिर वहीं से key, workflow ID कॉपी करें और webhook endpoint बनाएं. Live workflow ID के साथ sandbox key 401 या 403 का आम कारण है.

  2. Values अपने server configuration में डालें

    उन्हें server-side secrets के रूप में रखें. API key या signing secret को frontend code, public repository या mobile app में कभी न डालें.

  3. Session बनाएं

    https://verification.didit.me पर create session endpoint को अपनी key और workflow ID के साथ call करें. 401 का मतलब है कि key गलत, expired या रद्द है; workflow पर 403 का मतलब आमतौर पर यह है कि key किसी दूसरे application की है. देखें API errors.

  4. Test event भेजें

    डेवलपर्स → वेबहुक में अपना endpoint खोलें और परीक्षण इवेंट भेजें दबाएं. आपके server को signing secret से signature जांचना चाहिए और 2xx से जवाब देना चाहिए. अगर कुछ नहीं पहुंचता, तो देखें जब webhook कभी नहीं पहुंचता.

#संबंधित लेख

अभी भी अटके हैं? किसी व्यक्ति से बात करें।

अपने संगठन की ID और जिस सेशन के बारे में पूछ रहे हैं उसकी ID शामिल करें।

सपोर्ट से संपर्क करें