एपीआई क्वेरी पैरामीटर कुंजी-मूल्य जोड़े हैं जो सर्वर पर अतिरिक्त जानकारी भेजने के लिए एपीआई अनुरोध के यूआरएल में जोड़े जाते हैं। वे क्लाइंट (जैसे वेब ब्राउज़र या एप्लिकेशन) को सर्वर से अनुरोध करते समय कुछ मानदंड निर्दिष्ट करने या डेटा पास करने की अनुमति देते हैं।

यूआरएल के अंत में प्रश्न चिह्न (?) के बाद क्वेरी पैरामीटर जोड़े जाते हैं। प्रत्येक पैरामीटर एक कुंजी-मान जोड़ी है, जिसमें कुंजी और मान को बराबर चिह्न (=) द्वारा अलग किया जाता है। यदि एकाधिक क्वेरी पैरामीटर हैं, तो उन्हें एम्परसेंड (&) द्वारा अलग किया जाता है।

क्वेरी पैरामीटर्स का उपयोग कैसे किया जाता है:
डेटा फ़िल्टर करना: ग्राहक अपने इच्छित डेटा को फ़िल्टर करने के लिए क्वेरी पैरामीटर का उपयोग कर सकते हैं। उदाहरण के लिए, ?category=books सर्वर को केवल "किताबें" श्रेणी से आइटम वापस करने के लिए कह सकता है।

पेगिनेशन: क्वेरी पैरामीटर का उपयोग अक्सर एपीआई अनुरोधों में पेजिनेशन के लिए किया जाता है, जिससे क्लाइंट को यह निर्दिष्ट करने की अनुमति मिलती है कि परिणामों का कौन सा पेज लाना है और प्रति पेज कितने आइटम लाने हैं। उदाहरण: ?पेज=2&सीमा=10.

सॉर्टिंग और ऑर्डरिंग: क्वेरी पैरामीटर का उपयोग यह निर्दिष्ट करने के लिए किया जा सकता है कि डेटा को कैसे सॉर्ट किया जाना चाहिए। उदाहरण के लिए, ?sort=price&order=asc सर्वर को कीमत के अनुसार क्रमबद्ध वस्तुओं को आरोही क्रम में वापस करने का निर्देश दे सकता है।

पासिंग सर्च शब्द: एपीआई अक्सर ग्राहकों को डेटा खोजने की अनुमति देने के लिए क्वेरी पैरामीटर का उपयोग करते हैं। उदाहरण के लिए, ?search=laptop का उपयोग "लैपटॉप" शब्द से मेल खाने वाले सभी उत्पादों को खोजने के लिए किया जा सकता है।

क्वेरी पैरामीटर अत्यधिक लचीले हैं और एपीआई कैसे डिज़ाइन किया गया है इसके आधार पर विभिन्न तरीकों से उपयोग किया जा सकता है। वे क्लाइंट और सर्वर के बीच गतिशील इंटरैक्शन की अनुमति देते हैं, जिससे अनुकूलित डेटा का अनुरोध करना आसान हो जाता है।

1. बुनियादी क्वेरी पैरामीटर हैंडलिंग यह एपीआई हैंडलर दर्शाता है कि वैयक्तिकृत अभिवादन वापस करने के लिए क्वेरी पैरामीटर को कैसे निकाला और उपयोग किया जाए।

// pages/api/greet.js

export default function handler(req, res) {
  const { name } = req.query; // Get the 'name' query parameter
  const greeting = name ? `Hello, ${name}!` : 'Hello, stranger!';

  res.status(200).json({ message: greeting });
}

उदाहरण उपयोग:
/api/greet?name=जॉन वापस आएगा { "संदेश": "हैलो, जॉन!" }
/api/greet वापस आएगा {"संदेश": "हैलो, अजनबी!" }

1. एकाधिक क्वेरी पैरामीटर इस उदाहरण में, एपीआई हैंडलर उपयोगकर्ता इनपुट के आधार पर एक स्वरूपित प्रतिक्रिया वापस करने के लिए कई क्वेरी पैरामीटर निकालता है।

// pages/api/user.js

export default function handler(req, res) {
  const { name, age } = req.query; // Get 'name' and 'age' query parameters

  if (!name || !age) {
    res.status(400).json({ error: 'Name and age are required' });
    return;
  }

  res.status(200).json({ message: `User ${name} is ${age} years old.` });
}

उदाहरण उपयोग:
/api/user?name=Jane&age=28 वापस आएगा { "संदेश": "उपयोगकर्ता जेन 28 वर्ष का है।" }
/api/user?name=Jane वापस आएगा {"त्रुटि": "नाम और उम्र आवश्यक है" }

1. डिफ़ॉल्ट मानों के साथ वैकल्पिक क्वेरी पैरामीटर यह उदाहरण दिखाता है कि पैरामीटर अनुपलब्ध होने पर डिफ़ॉल्ट मान प्रदान करके वैकल्पिक क्वेरी पैरामीटर को कैसे प्रबंधित किया जाए।

// pages/api/score.js

export default function handler(req, res) {
  const { player = 'Anonymous', score = '0' } = req.query; // Default values if missing

  res.status(200).json({ message: `${player} scored ${score} points!` });
}

उदाहरण उपयोग:
/api/score?player=Alex&score=100 वापस आएगा { "संदेश": "एलेक्स ने 100 अंक बनाए!" }
/एपीआई/स्कोर वापस आएगा { "संदेश": "गुमनाम ने 0 अंक अर्जित किए!" }

1. क्वेरी पैरामीटर्स में ऐरे को संभालना Next.js क्वेरी पैरामीटर को सरणियों के रूप में पारित करने की अनुमति देता है। यह उदाहरण दर्शाता है कि मानों की एक श्रृंखला को कैसे संभालना है।

// pages/api/tags.js

export default function handler(req, res) {
  const { tags } = req.query; // Get 'tags' query parameter (array)

  if (!tags) {
    res.status(400).json({ error: 'Tags are required' });
    return;
  }

  res.status(200).json({ message: `You have selected these tags: ${tags.join(', ')}` });
}

उदाहरण उपयोग:
/api/tags?tags=javascript&tags=react वापस आएगा { "संदेश": "आपने ये टैग चुने हैं: जावास्क्रिप्ट, प्रतिक्रिया" }
/api/tags वापस आएगा {"त्रुटि": "टैग आवश्यक हैं" }

1. क्वेरी पैरामीटर्स के साथ पेजिनेशन यह हैंडलर दर्शाता है कि पेज और सीमा के लिए क्वेरी पैरामीटर का उपयोग करके पेजिनेशन कैसे लागू किया जाए।

// pages/api/items.js

export default function handler(req, res) {
  const { page = 1, limit = 10 } = req.query; // Default values for page and limit
  const startIndex = (page - 1) * limit;
  const endIndex = startIndex   Number(limit);

  // Dummy data for demonstration
  const items = Array.from({ length: 100 }, (_, i) => `Item ${i   1}`);
  const paginatedItems = items.slice(startIndex, endIndex);

  res.status(200).json({
    currentPage: page,
    perPage: limit,
    items: paginatedItems,
  });
}

उदाहरण उपयोग:
/api/items?page=2&limit=5 अगले 5 आइटम लौटाएगा, जैसे कि { "आइटम": ["आइटम 6", "आइटम 7", "आइटम 8", "आइटम 9", "आइटम 10"] }
/api/items (डिफ़ॉल्ट मान) पहले 10 आइटम लौटाएगा, जैसे कि { "आइटम": ["आइटम 1", "आइटम 2", ..., "आइटम 10"] }

ये उदाहरण नेक्स्ट.जेएस एपीआई मार्गों में क्वेरी पैरामीटर का उपयोग करने की लचीलापन प्रदर्शित करते हैं, जिसमें एकल या एकाधिक पैरामीटर, वैकल्पिक मान, सरणी और पेजिनेशन जैसे सामान्य पैटर्न शामिल होते हैं।