क्वेरी पैरामीटर क्या होते हैं? (Hindi गाइड)

आपने एक API रिक्वेस्ट भेजी और जवाब में हज़ारों रिकॉर्ड वापस आ गए। पर आपको तो उसमें से बस एक छोटा हिस्सा चाहिए था। आप उसे कैसे छाँटते हैं?

क्वेरी पैरामीटर वो छोटे फिल्टर होते हैं जो आप वेब एड्रेस के आखिर में ?key=value के रूप में जोड़ते हैं, ताकि सर्वर आपको पूरा डेटा नहीं, बल्कि ठीक वही लौटाए जो आप माँग रहे हैं।

अच्छी बात यह है कि आप इन्हें पहले से ही रोज़ इस्तेमाल करते हैं — बस आपको पता नहीं था कि इन्हें यही कहते हैं।

क्वेरी पैरामीटर क्या होते हैं?

क्वेरी पैरामीटर एक वेब एड्रेस (URL) के साथ जुड़ी अतिरिक्त जानकारी होती है, जो सर्वर को बताती है कि आप कौन-सा हिस्सा चाहते हैं। यह एड्रेस के बाद एक प्रश्न चिह्न ? से शुरू होती है, फिर एक key (नाम) और एक value (मान) जोड़ी के रूप में आती है।

सोचिए कि आप किसी दुकानदार से कहते हैं, “मुझे सब कुछ मत दिखाओ — सिर्फ नीली कमीज़ें दिखाओ।” क्वेरी पैरामीटर सर्वर के लिए ठीक यही काम करते हैं।

आप इन्हें रोज़ कहाँ इस्तेमाल करते हैं?

Amazon या Flipkart पर शॉपिंग की सोचिए। आप एक सर्च टाइप करते हैं, फिर फिल्टर लगाते हैं — कीमत, ब्रांड, रेटिंग। पेज फिर सिर्फ वही दिखाता है जो आपकी पसंद पर फिट बैठता है।

पीछे से, हर फिल्टर एक क्वेरी पैरामीटर बन जाता है और URL के साथ जुड़ जाता है। एक वेब रिक्वेस्ट भी ठीक यही कर सकती है। आप फिल्टर सीधे पते पर जोड़ते हैं, और सर्वर जवाब वापस भेजने से पहले उसे छाँट देता है।

क्वेरी पैरामीटर दिखते कैसे हैं?

इनकी बनावट बहुत आसान है। एक प्रश्न चिह्न आपके फिल्टर शुरू करता है, फिर एक key बराबर एक value आता है।

• ? — यहाँ से फिल्टर शुरू होते हैं।
• q=cats — एक key (q) बराबर एक value (cats), यानी सिर्फ cats के लिए सर्च।
• & — एक ऐम्परसैंड आपको एक और फिल्टर जोड़ने देता है।

तो एक पूरी रिक्वेस्ट ऐसी दिखेगी:

curl "https://api.com?q=cats"

यह सर्वर से सिर्फ और सिर्फ cats माँगता है। सर्वर आपके फिल्टर पढ़ता है और बाकी सब छोड़ देता है। एक से ज़्यादा फिल्टर के लिए ऐम्परसैंड लगाएँ:

curl "https://api.com?q=cats&limit=5"

क्वेरी पैरामीटर क्यों मायने रखते हैं?

क्योंकि असली API अक्सर हज़ारों रिकॉर्ड लौटाते हैं। उन सब में से ज़रूरी चीज़ ढूँढना धीमा और थका देने वाला होता है।

क्वेरी पैरामीटर आपको सिर्फ वो थोड़े रिकॉर्ड दिलाते हैं जो वाकई आपको चाहिए। इससे जवाब तेज़ आता है, कम डेटा ट्रैवल करता है, और आपका कोड साफ़ रहता है। यह वही बुनियादी सोच है जो आगे चलकर तब काम आती है जब आप पूरा फ्री Zero to AI Hero कोर्स करके असली ऐप्स बनाने लगते हैं।

आप इसे अभी कैसे आज़मा सकते हैं?

अपने टर्मिनल से एक रिक्वेस्ट भेजने का तरीका curl है, जो आपने पिछली लेसन में सीखा था। अब उसमें बस एक फिल्टर जोड़ना है।

1. एक API एड्रेस लीजिए, जैसे https://api.com।
2. आखिर में एक प्रश्न चिह्न जोड़िए — ?।
3. फिर लिखिए q= और उसके बाद अपना शब्द, जैसे q=cats।

देखिए कि जवाब कैसे छोटा और सटीक हो जाता है। अगर आप अभी curl और वेब रिक्वेस्ट की शुरुआत समझ रहे हैं, तो step by step पूरे कोर्स में हर कमांड को आसान Hindi में सिखाया जाता है।

मुख्य बातें (Key Takeaways)

• क्वेरी पैरामीटर वेब एड्रेस के आखिर में जुड़े फिल्टर होते हैं जो सर्वर से ठीक वही डेटा माँगते हैं जो आप चाहते हैं।
• बनावट आसान है: ?key=value, और कई फिल्टर के लिए बीच में &।
• आप इन्हें Amazon और Flipkart के फिल्टर में रोज़ इस्तेमाल करते हैं।
• curl "https://api.com?q=cats" सर्वर से सिर्फ cats माँगता है।
• ये जवाब तेज़ बनाते हैं क्योंकि सर्वर हज़ारों रिकॉर्ड नहीं, बस ज़रूरी हिस्सा लौटाता है।

अगली लेसन में हम स्टेटस कोड समझेंगे — यानी सर्वर का जवाब “ठीक है” था या नहीं, यह कैसे पता चलता है।

---

🚀 पूरा फ्री कोर्स देखें: Zero to AI Hero — हिंदी में सीखें। रोज़ नए लेसन। शुरुआत से AI इस्तेमाल करना और बनाना सीखें।