POST/api/public/access-request/email/start-verification

एक 6-अंकीय, 10 मिनट के लिए मान्य पुष्टिकरण कोड निर्दिष्ट ईमेल पते पर भेजें — यह एक प्रवेश अनुरोध से पहले पहला कदम है।

`POST /api/public/access-request/email/start-verification` किसी सार्वजनिक एक्सेस अनुरोध के लिए ईमेल सत्यापन शुरू करता है। इस रिक्वेस्ट के लिए लॉगिन की आवश्यकता नहीं है और इसमें जाँचा जाने वाला पता बॉडी फ़ील्ड `email` में होता है। सफल प्रोसेसिंग पर सिस्टम छह अंकों का पुष्टि कोड भेजता है, जो दस मिनट तक मान्य रहता है। रिस्पॉन्स में `ok`, एक `verification_id`, `expires_in_minutes` और `resend_cooldown_seconds` होते हैं। `verification_id` का उपयोग उसी ईमेल पते और प्राप्त कोड के साथ बाद वाले Verify रूट में किया जाना चाहिए। यह कोई लॉगिन टोकन नहीं है और इसे स्थायी उपयोगकर्ता पहचान के रूप में सहेजा या सार्वजनिक रूप से लॉग नहीं किया जाना चाहिए। यह एंडपॉइंट idempotent नहीं है। कई सफल कॉल कई सत्यापन प्रक्रियाएँ या नए कोड बना सकती हैं। इसलिए 15 मिनट के भीतर दस अनुरोधों की एक सख़्त IP-आधारित सीमा लागू होती है। इसके अलावा, रिस्पॉन्स 60 सेकंड की पुनः-भेजने की रोक का संकेत देता है। इस दौरान इंटरफ़ेस को दोबारा भेजना ट्रिगर नहीं करना चाहिए और शेष प्रतीक्षा समय को समझने योग्य ढंग से दिखाना चाहिए। सीमा पार होने पर रूट `429 RATE_LIMIT_EXCEEDED` लौटाता है। यदि डिलीवरी त्रुटि के कारण कोड नहीं भेजा जा सकता, तो `502 MAIL_NOT_SENT` प्रलेखित है। इन मामलों को अलग-अलग संभालना होगा: रेट लिमिट प्रतीक्षा करके हल होती है, जबकि मेल त्रुटि के लिए पहुँच योग्य पता और कार्यशील डिलीवरी आवश्यक है। सीक्रेट्स या आंतरिक मेल सर्वर डेटा त्रुटि संदेश में शामिल नहीं होने चाहिए। सफल मामले को एक वास्तविक `verification_id` के साथ लाइव सत्यापित किया गया। संबंधित संदेश एक अलग Fake-SMTP सर्वर के माध्यम से प्राप्त किया गया और छह अंकों का कोड वास्तविक ईमेल सामग्री से पढ़ा गया। इसके अलावा, बार-बार कॉल करने के बाद 429 वाला नकारात्मक मामला भी देखा गया। ठीक इसी प्रमाण का उल्लेख किया जा सकता है; इससे यह निष्कर्ष नहीं निकलता कि कोई एक्सेस अनुरोध या भुगतान प्रक्रिया सफलतापूर्वक पूरी हुई।

{"email":"max@example.com"}

{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}