API:Account creation/hi

खाता बनाना
इस प्रक्रिया में साधारणतः तीन चरण हैं:


 * 1)  से फील्ड्स और  से टोकन को लाना।
 * 2) लाए गए टोकन, सदस्य की जानकारी और दूसरे फील्ड्स के साथ एक POST अनुरोध भेजना और API को URL लौटा देना।
 * 3) जवाब का ठिकाना लेना, जिसे अधिक जानकारी के लिए और POST अनुरोधों की आवश्यकता भी हो सकती है।

उदाहरण 1: विशेष प्रमाणीकरण एक्सटेंशनों के अलावा विकि पर प्रक्रिया
किसी विशेष प्रमाणीकरण के बग़ैर विकि पर यह प्रक्रिया काफी सीधी-साधी है। अगर आपके कोड को पता है कि किन फील्ड्स की आवश्यकता होगी, यह शायद के कॉल को छोड़ दे और अंंदाज़ा लगा ले कि कौन-से फील्ड्स चाहिए होंगे (यानी सदस्यनाम, पासवर्ड और दोबारा लिखा गया पासवर्ड, ईमेल, शायद असली नाम)।

उदाहरण 2: CAPTCHA एक्सटेंशन वाले विकि पर प्रक्रिया
अगर आप चाहे तो इसमें पहले चरण को दो अलग-अलग चरणों में बाँट सकते हैं: से उपलब्ध फील्ड्स लाने के लिए एक और  से टोकन लाने के लिए एक।

उदाहरण कोड
ध्यान रखें कि यह उदाहरण और  अनुरोधों को अलग-अलग कर देता है और अंदाज़ा लगाता है कि विकि पर सिर्फ CAPTCHA ही होगा।

पहला चरण: से फील्ड्स और  से टोकन लाना
और को लाने की प्रक्रिया पिछले उदाहरण जैसी ही है तो इसे दोहराया नहीं गया है। द्वारा लौटाए गए अनुरोधों की सूची में CAPTCHA एक्सटेंशन और OpenID एक्सटेंशन की परिभाषाएँ भी मौजूद होंगी।

दूसरा चरण: CAPTCHA का जवाब देना और OpenID प्रमाणीकरण चुनना।
क्लाइंट से प्रदान किए redirecttarget पर सदस्य के ब्राउज़र को अनुप्रेषित करने की अपेक्षा रहेगी।

OpenID प्रदानकर्ता प्रमाणीकृत करके विकि पर Special:OpenIDConnectReturn पर अनुप्रेषित कर देगा, जो OpenID के जवाब को स्वीकार कर लेगा, और code और state पैरामीटर वाले API के पहले POST में दिए गए createreturnurl पर अनुप्रेषित कर देगा।

क्लाइंट को प्रक्रिया का नियंत्रण दे दिया जाता है और यह अपना अगला API अनुरोध करता है।

तीसरा चरण: OpenID से वापस।
क्लाइंट code और state API को वापस पोस्ट कर देता है। API के जवाब में दो-कारक प्रमाणीकरण एक्सटेंशन है जिसकी मदद से सदस्य अपने दूसरे कारक को सेट कर सकता है।

अब क्लाइंट सदस् को अपने दो-कारक प्रमाणीकरण ऐप पर एक नया खाता बनाने को और वर्तमान कोड दर्ज करने को कहेगा, या फिर सदस्य को 2FA को रद्द करने का विकल्प देगा। मान लेते हैं कि सदस्य 2FA का उपयोग नहीं करता है।

चौथा चरण: दो-कारक प्रमाणीकरण का उपयोग।
खाते का निर्माण सफल हुआ।

अगर खाते का निर्माण किसी भी समय असफल होता है, स्थिति FAIL वाला जवाब दिया जाएगा और साथ में सदस्य को दिखाने के लिए एक message भी।

अतिरिक्त टिप्पणियाँ

 * खातों के निर्माणों को Special:log/newusers पर रिकॉर्ड किया जाता है।

अगर आपने लॉग-इन किया है, खाता बनाते समय आपके सदस्यनाम को भी रिकॉर्ड किया जाएगा।


 * इस पृष्ठ पर प्रदान किए गए कोड स्निपेट्स का उपयोग करते समय याद रखें:
 * एक बार खाता बना लेने के बाद इसे हटाया नहीं जा सकता।
 * हमेशा एंडपॉइंट के रूप में का उपयोग करें ताकि आप गलती से मुख्य विकियों पर खाते न बना दें।
 * मीडियाविकि के साइट प्रबंधक और एक्सटेंशन विकासक कॉन्फिगरेशन फाइल में यह पंक्ति दर्ज करके इस API सुविधा को अक्षम कर सकते हैं: