मुख्य सामग्री पर जाएं
POST
cURL
इस endpoint का उपयोग तब करें जब आपको एक ही संगठन के भीतर सत्यापन ट्रैफ़िक, क्रेडेंशियल, ब्रांडिंग या रिपोर्टिंग को अलग रखना हो। यह खास तौर पर उन रीसेलर के लिए उपयोगी है जो हर ग्राहक के लिए एक एप्लिकेशन बनाते हैं। यह तब भी अच्छी तरह काम करता है जब आपकी अपनी कंपनी के कई प्रोडक्ट, ब्रांड, क्षेत्र, स्टेजिंग/प्रोडक्शन एनवायरनमेंट या उपयोग के मामले हों, जिन्हें एक ही API कुंजी और एप्लिकेशन-स्तर की सेटिंग्स साझा नहीं करनी चाहिए।
सभी Auth API endpoints https://apx.didit.me/auth/v2 का उपयोग करते हैं। https://verification.didit.me/v3/... endpoints (जैसे सत्र और वर्कफ़्लो) को कॉल करते समय लौटाई गई api_key को x-api-key के रूप में उपयोग करें।

डेटा स्थान

हर एप्लिकेशन अपना सत्यापन डेटा एक ही जगह संग्रहीत और संसाधित करता है, यानी उसका डेटा स्थान, जिसे आप एप्लिकेशन बनाते समय data_location के साथ चुनते हैं। अभी केवल एक स्थान उपलब्ध है: eu, यानी यूरोपीय संघ (आयरलैंड)। यह तब भी डिफ़ॉल्ट होता है जब आप यह फ़ील्ड छोड़ देते हैं। ऑस्ट्रेलिया (सिडनी, au) और मेक्सिको (mx) जल्द आ रहे हैं। जो अनुरोध इनमें से किसी का नाम लेता है, उसका जवाब 400 This data location is not available yet. होता है और कुछ भी नहीं बनता। एप्लिकेशन को पढ़ने पर हर बार उसका data_location लौटता है, और एप्लिकेशन बन जाने के बाद इसे बदला नहीं जा सकता। देखें: डेटा स्थान।

प्राधिकरण

Authorization
string
header
आवश्यक

POST /programmatic/login/ या POST /programmatic/verify-email/ द्वारा लौटाया गया RS256-हस्ताक्षरित JWT access_token। Authorization: Bearer <access_token> के रूप में भेजें। डिफ़ॉल्ट जीवनकाल 86400 सेकंड (24 घंटे) है। यह token केवल apx.didit.me/auth/v2 पर खाता प्रबंधन endpoints के लिए मान्य है। सत्यापन API (verification.didit.me/v3) इसके बजाय x-api-key के रूप में दीर्घकालिक api_key का उपयोग करता है।

पथ पैरामीटर

org_id
string<uuid>
आवश्यक

संगठन का UUID। इसे GET /organizations/me/ से देखें।

उदाहरण:

"a1b2c3d4-5678-90ab-cdef-111111111111"

बॉडी

application/json

सभी फ़ील्ड वैकल्पिक हैं। बॉडी को छोड़ने पर डिफ़ॉल्ट नाम "<organization name> App" वाला ऐसा एप्लिकेशन बनता है जिसमें कोई सार्वजनिक URL कॉन्फ़िगर नहीं है।

सभी फ़ील्ड वैकल्पिक हैं। एक खाली बॉडी भेजने से यूरोपीय संघ में डिफ़ॉल्ट नाम वाला एक एप्लिकेशन बनता है।

name
string

एप्लिकेशन प्रदर्शन नाम। डिफ़ॉल्ट "<organization name> App" है।

उदाहरण:

"Acme Customer App"

website_url
string

इस एप्लिकेशन से संबद्ध वेबसाइट या ऐप URL।

उदाहरण:

"https://acme.example"

redirect_uris
string[]

OAuth-शैली और सत्यापन रीडायरेक्ट फ़्लो के लिए स्वीकृत रीडायरेक्ट URI।

उदाहरण:
terms_url
string

सत्यापन फ़्लो में दिखाया गया सेवा की शर्तों का URL।

उदाहरण:

"https://acme.example/terms"

privacy_url
string

सत्यापन फ़्लो में दिखाया गया गोपनीयता नीति URL।

उदाहरण:

"https://acme.example/privacy"

description
string

एप्लिकेशन के लिए आंतरिक विवरण (अंतिम उपयोगकर्ताओं को नहीं दिखाया जाता)।

data_location
enum<string>

एप्लिकेशन का सत्यापन डेटा कहाँ संग्रहीत और संसाधित किया जाता है, जिसे एप्लिकेशन बनाते समय चुना जाता है। eu यूरोपीय संघ (आयरलैंड) है, जो डिफ़ॉल्ट है। au (ऑस्ट्रेलिया, सिडनी) और mx (मेक्सिको) जल्द ही आ रहे हैं: उनका नाम देने वाला अनुरोध 400 This data location is not available yet. उत्तर देता है। किसी संगठन का सैंडबॉक्स एप्लिकेशन हमेशा यूरोपीय संघ में होता है।

उपलब्ध विकल्प:
eu,
au,
mx
उदाहरण:

"eu"

प्रतिक्रिया

एप्लिकेशन बनाया गया। रिस्पॉन्स में दीर्घकालिक api_key शामिल होती है; इसे अभी सहेजें और प्रत्येक https://verification.didit.me/v3/... कॉल पर x-api-key हेडर के रूप में उपयोग करें।

पूर्ण एप्लिकेशन रिकॉर्ड। निर्माण के बाद uuid, client_id, और api_key कभी नहीं बदलते। data_location भी नहीं बदलता, सिवाय आपके संगठन के साथ बनाए गए लाइव एप्लिकेशन पर उपयोग किए जाने से पहले एक बार (अपडेट अनुरोध देखें)।

uuid
string<uuid>

एप्लिकेशन UUID। बाद के कॉलों में {app_id} के रूप में उपयोग करें।

उदाहरण:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

Didit कंसोल में दिखाया जाने वाला एप्लिकेशन प्रदर्शन नाम।

उदाहरण:

"Acme Production App"

client_id
string

सार्वजनिक क्लाइंट पहचानकर्ता, OAuth-शैली फ़्लो में एम्बेड करने के लिए सुरक्षित।

उदाहरण:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

दीर्घकालिक सीक्रेट (जिसे client_secret भी कहा जाता है)। https://verification.didit.me/v3/... (सत्र, वर्कफ़्लो, AML, आदि) के प्रत्येक कॉल के लिए x-api-key हेडर के रूप में उपयोग करें। इसे क्रेडेंशियल की तरह रखें; क्लाइंट-साइड पर कभी भी उजागर न करें। नई कुंजियाँ sk_live_ (लाइव एप्लिकेशन) या sk_test_ (सैंडबॉक्स एप्लिकेशन) से शुरू होती हैं, जिसके बाद 43 URL-सुरक्षित वर्ण (अक्षर, अंक, - और _) होते हैं। इस प्रारूप से पहले बनाई गई कुंजियों में कोई उपसर्ग नहीं होता है और वे बिना किसी बदलाव के काम करती रहती हैं। आपके द्वारा अपना खाता पुनर्प्राप्त करने के 72 घंटों तक, सूचीबद्ध करना, प्राप्त करना और अपडेट करना कुंजी के स्थान पर यहाँ एक खाली स्ट्रिंग लौटाते हैं।

उदाहरण:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

इस एप्लिकेशन से संबद्ध वेबसाइट या ऐप URL।

उदाहरण:

"https://acme.example"

redirect_uris
string[]

OAuth-शैली और सत्यापन रीडायरेक्ट फ़्लो के लिए स्वीकृत रीडायरेक्ट URI।

उदाहरण:
terms_url
string | null

सत्यापन फ़्लो में दिखाया गया सेवा की शर्तों का URL।

उदाहरण:

"https://acme.example/terms"

privacy_url
string | null

सत्यापन फ़्लो में दिखाया गया गोपनीयता नीति URL।

उदाहरण:

"https://acme.example/privacy"

description
string | null

एप्लिकेशन के लिए आंतरिक विवरण (अंतिम उपयोगकर्ताओं को नहीं दिखाया जाता)।

created_at
string<date-time>
उदाहरण:

"2025-06-01T10:00:00Z"

data_location
enum<string>

एप्लिकेशन का सत्यापन डेटा कहाँ संग्रहीत और संसाधित किया जाता है, जिसे एप्लिकेशन बनाते समय चुना जाता है। eu यूरोपीय संघ (आयरलैंड) है, जो डिफ़ॉल्ट है। au (ऑस्ट्रेलिया, सिडनी) और mx (मेक्सिको) जल्द ही आ रहे हैं: उनका नाम देने वाला अनुरोध 400 This data location is not available yet. उत्तर देता है। किसी संगठन का सैंडबॉक्स एप्लिकेशन हमेशा यूरोपीय संघ में होता है।

उपलब्ध विकल्प:
eu,
au,
mx
उदाहरण:

"eu"

products
object[]
read-only

एप्लिकेशन के उत्पाद। हमेशा तीनों, इसी क्रम में: identity, transactions, authentication। एक नए एप्लिकेशन में प्रत्येक मॉड्यूल चालू होने के साथ identity सक्षम होती है, और transactions व authentication अक्षम होते हैं। केवल-पढ़ने योग्य: निर्माण या अपडेट बॉडी में products कुंजी को अनदेखा कर दिया जाता है।

उदाहरण:
अंतिम संशोधन 7 नवंबर 2026