Sandbox
पहचान सत्यापन के लिए Sandbox API keys।
sandbox key प्रोडक्शन जैसा ही API, होस्टेड पेज और webhook फ़्लो चलाती है, ऐसी key पर जिसका बिल कभी नहीं बनता। कीमत पर बात करने से पहले यह देखने का सबसे तेज़ तरीका है कि ShieldID आपके लिए उपयुक्त है या नहीं।
यह कैसे काम करता है
वही पाइपलाइन। अलग key। कोई इनवॉइस नहीं।
Sandbox कोई सरल डेमो मोड नहीं है — यह असली सत्यापन पाइपलाइन है, जिसे केवल इस बात से अलग किया जाता है कि आप कौन-सी key भेजते हैं।
| Key prefix | vk_sand_… प्रमाणीकरण के समय sandbox key की पहचान कराता है। कॉन्फ़िगर करने के लिए कोई अलग sandbox खाता या डैशबोर्ड नहीं है। |
|---|---|
| Environment स्टैंप | sandbox key से बनने वाले हर session, परिणाम और webhook में environment: "sandbox" होता है, ताकि आगे की प्रक्रिया में sandbox में बनी किसी चीज़ को असली सत्यापन समझने की गलती न हो। |
| बिलिंग | हर प्लान पर sandbox sessions का कभी बिल नहीं बनता, चाहे आप अपना integration बनाने और टेस्ट करने के लिए जितने भी sessions चलाएँ। |
| सत्यापन स्वयं | असली: आपका अपना दस्तावेज़, आपका अपना चेहरा, वही जाँचें। नकली टेस्ट दस्तावेज़ों का कोई अलग सेट नहीं है — उत्पाद का व्यवहार देखने के लिए आप खुद का सत्यापन करते हैं। |
key पाना
आज ही अनुरोध करें। सेल्फ़-सर्व जल्द आ रहा है।
योग्य प्लान पर सेल्फ़-सर्व sandbox key बनाना नियोजित है, लेकिन अभी समय तय नहीं है। जब तक यह उपलब्ध नहीं होता, संपर्क फ़ॉर्म के ज़रिए अनुरोध करने पर आपको सीधे key मिल जाती है।
आज
संपर्क फ़ॉर्म पर हमें थोड़ा बताएँ कि आप क्या बना रहे हैं और हम आपको sandbox key उपलब्ध करा देंगे — ज़्यादातर अनुरोध उसी कार्यदिवस में पूरे हो जाते हैं।
जल्द आ रहा है
जल्द आ रहा हैयोग्य प्लान पर सेल्फ़-सर्व sandbox key बनाना नियोजित है, लेकिन अभी समय तय नहीं है, ताकि साइन अप करते ही आप key जनरेट कर सकें।
खुद आज़माएँ
टेस्ट परिदृश्य जो आप अपने फ़ोन पर चला सकते हैं।
नकली दस्तावेज़ों की ज़रूरत नहीं — हर रास्ते का असली व्यवहार देखने के लिए इन्हें अपने ही ID पर चलाएँ।
एकदम सफल सत्यापन
एक session बनाएँ, होस्टेड पेज खोलें, अपने ID की फ़ोटो लें और liveness चैलेंज पूरा करें। देखें कि checks.document, checks.liveness, checks.antispoof और checks.face_match हर एक PASS लौटाता है।
कैमरे की अनुमति न देना
होस्टेड पेज जब कैमरे की अनुमति माँगे तो उसे अस्वीकार करें। session FAILED पर समाप्त होता है और उसमें एक failure_reason होता है, जिसके आधार पर आप सटीक त्रुटि संदेश बना सकते हैं।
विफलता के बाद दोबारा प्रयास (जल्द आ रहा है)
FAILED session के verification_url को दोबारा खोलकर उसे दूसरे प्रयास के लिए PENDING पर रीसेट करना अभी उपलब्ध नहीं है। आज के लिए FAILED को अंतिम स्थिति मानें — आवेदक दोबारा कोशिश करना चाहे तो नया session बनाएँ।
समाप्त हो चुका session
एक session बनाएँ और उसे छुए बिना छोड़ दें। डिफ़ॉल्ट अवधि के बाद वह EXPIRED हो जाता है, जिसमें कोई व्यक्ति या जाँच का डेटा नहीं होता — आपके UI के टाइमआउट संदेश को टेस्ट करने के लिए यह अच्छी स्थिति है।
एक रद्द किया गया सेशन
किसी PENDING सेशन पर DELETE /v1/sessions/{id} को कॉल करें, फिर verification_url खोलने का प्रयास करें। पुष्टि करें कि आपका ऐप रद्द किए गए सेशन को त्रुटि नहीं, बल्कि पूर्ण मानता है।
फ़्रेंच locale
locale: "fr" के साथ एक session बनाएँ और पुष्टि करें कि होस्टेड पेज और आपका अपना return-URL हैंडलिंग फ़्रेंच भाषी आवेदक के लिए सही ढंग से दिखते हैं।
सीमाएँ
Sandbox क्या नहीं करता।
सीधे जवाब, छोटे अक्षरों की शर्तें नहीं।
- Sandbox की प्रोडक्शन से अलग कोई rate limit नहीं है — फ़िलहाल किसी भी request पर प्लान-स्तर की सीमाओं के कारण रोक नहीं लगती; वह प्रवर्तन अभी लागू नहीं है।
- Sandbox और प्रोडक्शन केवल key prefix से अलग होते हैं, अलग खातों, डैशबोर्ड या दस्तावेज़ सेट से नहीं।
- sandbox session किसी असली दस्तावेज़ का असली सत्यापन है। टेस्ट के लिए किसी और का ID इस्तेमाल न करें — अपना ही सत्यापित करें।
प्रश्न
Sandbox FAQ।
key पाएँ
sandbox key का अनुरोध करें।
हमें बताएँ कि आप क्या बना रहे हैं और हम टेस्टिंग शुरू करने के लिए आपको एक key उपलब्ध करा देंगे।
Sandbox सेशन का कभी बिल नहीं बनता।