आज क्या जवाब देता है
सब कुछ https://api.password.es के अंतर्गत है। तीन पते उत्तर देते हैं और एक अभी नहीं; पूरा संदर्भ —पैरामीटर, फ़ील्ड और त्रुटियाँ— दस्तावेज़ीकरण में है।
- POST/v1/generate एक या कई पासवर्ड बनाता है और उनका विश्लेषण लौटाता है।
- GET/openapi.json API का विवरण, OpenAPI 3.1 में।
-
POST/mcp
सहायकों के लिए MCP सर्वर। एक उपकरण:
generate_password। - POST/v1/check 501 अभी मौजूद नहीं है। त्रुटि बताती है कि क्या कमी है और तब तक कहाँ जाएँ।
दस सेकंड में
न कुंजी, न पंजीकरण, न हेडर। पूरी कॉल बस इतनी है:
curl -X POST https://api.password.es/v1/generate
यह 16 वर्ण का एक पासवर्ड और उसका विश्लेषण लौटाता है: बिट, वह किसी हमले के आगे कितना टिकेगा, और 0 से 4 तक का एक स्तर — वही आँकड़े जो आप इस साइट के मुखपृष्ठ पर देखते हैं। बाक़ी सब विकल्प हैं।
पूरा संदर्भ
API के दस्तावेज़ों में नौ पैरामीटर, प्रतिक्रिया का हर फ़ील्ड एक-एक करके समझाया हुआ, त्रुटि कोड, सीमाएँ और भाषा कैसे चुनी जाती है — सब है। वही पन्ना संपादक के बगल में खोला जाता है; यह वाला बताता है कि माजरा क्या है।
जो अभी नहीं है
कोई तारीख़ नहीं, क्योंकि है ही नहीं। यह इसलिए लिखा है कि दिखे यह किस ओर जा रहा है, वादे के तौर पर नहीं।
/v1/check। मंशा यह है कि यह किसी पासवर्ड का विश्लेषण जाँचकर्ता जैसे ही आँकड़ों से करे। आज यह501लौटाता है और वजह बताता है: इसके लिए वेब वाला ठीक वही पैटर्न इंजन चाहिए, और वह इनपुट के हिसाब से हर अनुरोध पर 11 मिलीसेकंड से 3.6 सेकंड तक CPU लेता है। यह एक फ़ैसले का इंतज़ार कर रहा है —लंबाई की ऊपरी सीमा कहाँ रखें— जो अभी लिया नहीं गया।- k-anonymity से जाँच: यह देखना कि कोई पासवर्ड किसी लीक में है या नहीं, बिना उसे पूरा भेजे।
- स्थानीय पैकेज: वही इंजन, आपकी अपनी मशीन पर चलाने के लिए, ताकि हमें कभी बुलाना ही न पड़े। यह इस सबका महँगा हिस्सा है, इसलिए इसे तय मत मानिए।
- कुंजियाँ और योजनाएँ। न तारीख़, न वादा। आज न पंजीकरण है न क़ीमतें, और इसीलिए पूरे API में उनका एक भी लिंक नहीं है — सीमा पार होने की त्रुटि में भी नहीं।
जो हम नहीं छिपाएँगे
पासवर्ड बनाने वाला API, गहराई में, एक ऐंटीपैटर्न है: पासवर्ड नेटवर्क से गुज़रता है और किसी ऐसी मशीन से होकर जाता है जो आपकी नहीं है। यह चेतावनी अभी चाहिए, जब इसे सचमुच बुलाया जा सकता है — तब नहीं जब यह पन्ना एक वादा भर था।
इसीलिए यह सिर्फ़ यहाँ नहीं रहती: हर प्रतिक्रिया अपना notice साथ लाती है जो यही बात कहती है, उसी भाषा में जो आप माँगें। जिस पासवर्ड को आप सचमुच इस्तेमाल करेंगे, उसके लिए इस साइट का जनरेटर पूरा आपके ब्राउज़र में चलता है और कुछ नहीं भेजता; जाँचकर्ता भी वैसा ही।
इस ऐंटीपैटर्न से निकलने का असली रास्ता ऊपर की सूची वाला स्थानीय पैकेज है: वही इंजन, आपकी मशीन पर, बीच में हम नहीं। यह एक मंशा है, तारीख़ नहीं।