हिन्दी

Next.js API रूट्स को समझें और अपने React एप्लिकेशन में फुल-स्टैक डेवलपमेंट क्षमताओं को अनलॉक करें। पैटर्न, सर्वोत्तम अभ्यास और डिप्लॉयमेंट रणनीतियाँ सीखें।

Next.js API रूट्स: फुल-स्टैक डेवलपमेंट पैटर्न

Next.js ने दमदार और स्केलेबल वेब एप्लिकेशन बनाने के लिए एक मजबूत फ्रेमवर्क प्रदान करके React डेवलपमेंट में क्रांति ला दी है। इसकी प्रमुख विशेषताओं में से एक API रूट्स है, जो डेवलपर्स को सीधे अपने Next.js प्रोजेक्ट्स के भीतर बैकएंड कार्यक्षमता बनाने में सक्षम बनाती है। यह दृष्टिकोण डेवलपमेंट को सुव्यवस्थित करता है, डिप्लॉयमेंट को सरल बनाता है, और शक्तिशाली फुल-स्टैक क्षमताओं को अनलॉक करता है।

Next.js API रूट्स क्या हैं?

Next.js API रूट्स सर्वरलेस फ़ंक्शन हैं जो सीधे आपकी /pages/api डायरेक्टरी के अंदर लिखे जाते हैं। इस डायरेक्टरी की प्रत्येक फ़ाइल एक API एंडपॉइंट बन जाती है, जो स्वचालित रूप से HTTP अनुरोधों को उसके संबंधित फ़ंक्शन पर रूट करती है। यह एक अलग बैकएंड सर्वर की आवश्यकता को समाप्त करता है, जिससे आपके एप्लिकेशन आर्किटेक्चर को सरल बनाया जाता है और परिचालन लागत कम हो जाती है।

इन्हें अपने Next.js ऐप के अंदर रहने वाले छोटे सर्वरलेस फ़ंक्शन के रूप में सोचें। वे GET, POST, PUT, DELETE जैसे HTTP अनुरोधों का जवाब देते हैं, और डेटाबेस, बाहरी API और अन्य सर्वर-साइड संसाधनों के साथ इंटरैक्ट कर सकते हैं। महत्वपूर्ण बात यह है कि वे केवल सर्वर पर चलते हैं, उपयोगकर्ता के ब्राउज़र में नहीं, जिससे API कीज़ जैसे संवेदनशील डेटा की सुरक्षा सुनिश्चित होती है।

API रूट्स के प्रमुख लाभ

API रूट्स के साथ शुरुआत करना

Next.js में एक API रूट बनाना सीधा है। बस /pages/api डायरेक्टरी के भीतर एक नई फ़ाइल बनाएं। फ़ाइल का नाम रूट के पाथ को निर्धारित करेगा। उदाहरण के लिए, /pages/api/hello.js नामक फ़ाइल बनाने से /api/hello पर एक API एंडपॉइंट बन जाएगा।

उदाहरण: एक सरल ग्रीटिंग API

यहाँ एक API रूट का एक मूल उदाहरण है जो एक JSON प्रतिक्रिया देता है:


// pages/api/hello.js

export default function handler(req, res) {
  res.status(200).json({ message: 'Next.js API रूट से नमस्ते!' });
}

यह कोड एक एसिंक्रोनस फ़ंक्शन handler को परिभाषित करता है जो दो आर्ग्यूमेंट्स प्राप्त करता है:

यह फ़ंक्शन HTTP स्टेटस कोड को 200 (OK) पर सेट करता है और एक संदेश के साथ JSON प्रतिक्रिया देता है।

विभिन्न HTTP मेथड्स को हैंडल करना

आप अपनी API रूट के भीतर req.method प्रॉपर्टी की जाँच करके विभिन्न HTTP मेथड्स (GET, POST, PUT, DELETE, आदि) को हैंडल कर सकते हैं। यह आपको आसानी से RESTful API बनाने की अनुमति देता है।


// pages/api/todos.js

export default async function handler(req, res) {
  if (req.method === 'GET') {
    // डेटाबेस से सभी टूडू प्राप्त करें
    const todos = await fetchTodos();
    res.status(200).json(todos);
  } else if (req.method === 'POST') {
    // एक नया टूडू बनाएं
    const newTodo = await createTodo(req.body);
    res.status(201).json(newTodo);
  } else {
    // असमर्थित मेथड्स को हैंडल करें
    res.status(405).json({ message: 'मेथड की अनुमति नहीं है' });
  }
}

यह उदाहरण दिखाता है कि एक काल्पनिक /api/todos एंडपॉइंट के लिए GET और POST अनुरोधों को कैसे हैंडल किया जाए। इसमें असमर्थित तरीकों के लिए एरर हैंडलिंग भी शामिल है।

API रूट्स के साथ फुल-स्टैक डेवलपमेंट पैटर्न

Next.js API रूट्स विभिन्न फुल-स्टैक डेवलपमेंट पैटर्न को सक्षम करते हैं। यहाँ कुछ सामान्य उपयोग के मामले दिए गए हैं:

1. डेटा फ़ेचिंग और मैनिपुलेशन

API रूट्स का उपयोग डेटाबेस, बाहरी API, या अन्य डेटा स्रोतों से डेटा प्राप्त करने के लिए किया जा सकता है। उनका उपयोग डेटा में हेरफेर करने के लिए भी किया जा सकता है, जैसे कि रिकॉर्ड बनाना, अपडेट करना या हटाना।

उदाहरण: डेटाबेस से उपयोगकर्ता डेटा प्राप्त करना


// pages/api/users/[id].js
import { query } from '../../../lib/db';

export default async function handler(req, res) {
  const { id } = req.query;

  try {
    const results = await query(
      'SELECT * FROM users WHERE id = ?',
      [id]
    );

    if (results.length === 0) {
      return res.status(404).json({ message: 'उपयोगकर्ता नहीं मिला' });
    }

    res.status(200).json(results[0]);
  } catch (error) {
    console.error(error);
    res.status(500).json({ message: 'आंतरिक सर्वर त्रुटि' });
  }
}

यह उदाहरण URL में दिए गए उपयोगकर्ता आईडी के आधार पर डेटाबेस से उपयोगकर्ता डेटा प्राप्त करता है। यह डेटाबेस के साथ इंटरैक्ट करने के लिए एक डेटाबेस क्वेरी लाइब्रेरी (माना जाता है कि यह lib/db में है) का उपयोग करता है। SQL इंजेक्शन कमजोरियों को रोकने के लिए पैरामीटराइज्ड क्वेरी के उपयोग पर ध्यान दें।

2. प्रमाणीकरण और प्राधिकरण

API रूट्स का उपयोग प्रमाणीकरण और प्राधिकरण तर्क को लागू करने के लिए किया जा सकता है। आप उनका उपयोग उपयोगकर्ता क्रेडेंशियल्स को सत्यापित करने, JWT टोकन उत्पन्न करने और संवेदनशील संसाधनों की सुरक्षा के लिए कर सकते हैं।

उदाहरण: उपयोगकर्ता प्रमाणीकरण


// pages/api/login.js
import bcrypt from 'bcryptjs';
import jwt from 'jsonwebtoken';
import { query } from '../../lib/db';

export default async function handler(req, res) {
  if (req.method === 'POST') {
    const { email, password } = req.body;

    try {
      const results = await query(
        'SELECT * FROM users WHERE email = ?',
        [email]
      );

      if (results.length === 0) {
        return res.status(401).json({ message: 'अमान्य क्रेडेंशियल्स' });
      }

      const user = results[0];

      const passwordMatch = await bcrypt.compare(password, user.password);

      if (!passwordMatch) {
        return res.status(401).json({ message: 'अमान्य क्रेडेंशियल्स' });
      }

      const token = jwt.sign(
        { userId: user.id, email: user.email },
        process.env.JWT_SECRET,
        { expiresIn: '1h' }
      );

      res.status(200).json({ token });
    } catch (error) {
      console.error(error);
      res.status(500).json({ message: 'आंतरिक सर्वर त्रुटि' });
    }
  } else {
    res.status(405).json({ message: 'मेथड की अनुमति नहीं है' });
  }
}

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

3. फॉर्म हैंडलिंग और डेटा सबमिशन

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

उदाहरण: संपर्क फ़ॉर्म सबमिशन


// pages/api/contact.js
import { sendEmail } from '../../lib/email';

export default async function handler(req, res) {
  if (req.method === 'POST') {
    const { name, email, message } = req.body;

    try {
      await sendEmail({
        to: 'admin@example.com',
        subject: 'नया संपर्क फ़ॉर्म सबमिशन',
        text: `नाम: ${name}\nईमेल: ${email}\nसंदेश: ${message}`,
      });

      res.status(200).json({ message: 'ईमेल सफलतापूर्वक भेजा गया' });
    } catch (error) {
      console.error(error);
      res.status(500).json({ message: 'ईमेल भेजने में विफल' });
    }
  } else {
    res.status(405).json({ message: 'मेथड की अनुमति नहीं है' });
  }
}

यह उदाहरण व्यवस्थापक को एक ईमेल भेजकर संपर्क फ़ॉर्म सबमिशन को संभालता है। यह ईमेल भेजने के लिए एक ईमेल भेजने वाली लाइब्रेरी (माना जाता है कि यह lib/email में है) का उपयोग करता है। आपको admin@example.com को वास्तविक प्राप्तकर्ता ईमेल पते से बदलना चाहिए।

4. वेबहुक और इवेंट हैंडलिंग

API रूट्स का उपयोग वेबहुक को संभालने और बाहरी सेवाओं से घटनाओं का जवाब देने के लिए किया जा सकता है। यह आपको अपने Next.js एप्लिकेशन को अन्य प्लेटफार्मों के साथ एकीकृत करने और कार्यों को स्वचालित करने की अनुमति देता है।

उदाहरण: एक स्ट्राइप वेबहुक को हैंडल करना


// pages/api/stripe-webhook.js
import Stripe from 'stripe';

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);

export const config = {
  api: {
    bodyParser: false, // डिफ़ॉल्ट बॉडी पार्सिंग को अक्षम करें
  },
};

async function buffer(req) {
  const chunks = [];
  for await (const chunk of req) {
    chunks.push(chunk);
  }
  return Buffer.concat(chunks).toString();
}

export default async function handler(req, res) {
  if (req.method === 'POST') {
    const sig = req.headers['stripe-signature'];

    let event;

    try {
      const buf = await buffer(req);
      event = stripe.webhooks.constructEvent(buf, sig, process.env.STRIPE_WEBHOOK_SECRET);
    } catch (err) {
      console.log(`वेबहुक त्रुटि: ${err.message}`);
      res.status(400).send(`वेबहुक त्रुटि: ${err.message}`);
      return;
    }

    // इवेंट को हैंडल करें
    switch (event.type) {
      case 'payment_intent.succeeded':
        const paymentIntent = event.data.object;
        console.log(`${paymentIntent.amount} के लिए पेमेंटइंटेंट सफल रहा!`);
        // फिर सफल पेमेंट इंटेंट को संभालने के लिए एक मेथड को परिभाषित करें और कॉल करें।
        // handlePaymentIntentSucceeded(paymentIntent);
        break;
      case 'payment_method.attached':
        const paymentMethod = event.data.object;
        // फिर पेमेंट मेथड के सफल अटैचमेंट को संभालने के लिए एक मेथड को परिभाषित करें और कॉल करें।
        // handlePaymentMethodAttached(paymentMethod);
        break;
      default:
        // अप्रत्याशित इवेंट प्रकार
        console.log(`अनहैंडल्ड इवेंट प्रकार ${event.type}.`);
    }

    // इवेंट की प्राप्ति को स्वीकार करने के लिए 200 प्रतिक्रिया लौटाएं
    res.status(200).json({ received: true });
  } else {
    res.setHeader('Allow', 'POST');
    res.status(405).end('मेथड की अनुमति नहीं है');
  }
}

यह उदाहरण हस्ताक्षर को सत्यापित करके और इवेंट डेटा को संसाधित करके एक स्ट्राइप वेबहुक को संभालता है। यह डिफ़ॉल्ट बॉडी पार्सर को अक्षम करता है और रॉ रिक्वेस्ट बॉडी को पढ़ने के लिए एक कस्टम बफर फ़ंक्शन का उपयोग करता है। डिफ़ॉल्ट बॉडी पार्सर को अक्षम करना महत्वपूर्ण है क्योंकि स्ट्राइप को हस्ताक्षर सत्यापन के लिए रॉ बॉडी की आवश्यकता होती है। अपने स्ट्राइप डैशबोर्ड में अपने स्ट्राइप वेबहुक एंडपॉइंट को कॉन्फ़िगर करना और STRIPE_WEBHOOK_SECRET एनवायरनमेंट वेरिएबल सेट करना याद रखें।

API रूट्स के लिए सर्वोत्तम अभ्यास

अपने API रूट्स की गुणवत्ता और रखरखाव सुनिश्चित करने के लिए, इन सर्वोत्तम प्रथाओं का पालन करें:

1. अपने कोड को मॉड्यूलर बनाएं

बड़े, मोनोलिथिक API रूट्स लिखने से बचें। इसके बजाय, अपने कोड को छोटे, पुन: प्रयोज्य मॉड्यूल में तोड़ें। यह आपके कोड को समझना, परीक्षण करना और बनाए रखना आसान बनाता है।

2. एरर हैंडलिंग लागू करें

अपने API रूट्स में त्रुटियों को ठीक से संभालें। अपवादों को पकड़ने के लिए try...catch ब्लॉक का उपयोग करें और क्लाइंट को उचित त्रुटि प्रतिक्रियाएं लौटाएं। डिबगिंग और निगरानी में मदद के लिए त्रुटियों को लॉग करें।

3. इनपुट डेटा को मान्य करें

सुरक्षा कमजोरियों को रोकने और डेटा अखंडता सुनिश्चित करने के लिए हमेशा क्लाइंट से इनपुट डेटा को मान्य करें। सत्यापन स्कीमा को परिभाषित करने और डेटा बाधाओं को लागू करने के लिए Joi या Yup जैसी सत्यापन लाइब्रेरी का उपयोग करें।

4. संवेदनशील डेटा को सुरक्षित रखें

संवेदनशील डेटा, जैसे API कीज़ और डेटाबेस क्रेडेंशियल्स, को एनवायरनमेंट वेरिएबल्स में स्टोर करें। कभी भी संवेदनशील डेटा को अपने कोड रिपॉजिटरी में कमिट न करें।

5. रेट लिमिटिंग लागू करें

रेट लिमिटिंग लागू करके अपने API रूट्स को दुरुपयोग से बचाएं। यह एक निश्चित समय अवधि के भीतर एक क्लाइंट द्वारा किए जा सकने वाले अनुरोधों की संख्या को सीमित करता है। express-rate-limit या limiter जैसी रेट लिमिटिंग लाइब्रेरी का उपयोग करें।

6. API कीज़ सुरक्षित करें

API कीज़ को सीधे क्लाइंट-साइड कोड में उजागर न करें। अपनी API कीज़ को अनधिकृत पहुंच से बचाने के लिए हमेशा अपने API रूट्स के माध्यम से अनुरोधों को प्रॉक्सी करें। API कीज़ को अपने सर्वर पर एनवायरनमेंट वेरिएबल्स में सुरक्षित रूप से स्टोर करें।

7. एनवायरनमेंट वेरिएबल्स का उपयोग करें

अपने कोड में कॉन्फ़िगरेशन मानों को हार्डकोड करने से बचें। इसके बजाय, कॉन्फ़िगरेशन सेटिंग्स को स्टोर करने के लिए एनवायरनमेंट वेरिएबल्स का उपयोग करें। यह विभिन्न वातावरणों (डेवलपमेंट, स्टेजिंग, प्रोडक्शन) में आपके एप्लिकेशन को प्रबंधित करना आसान बनाता है।

8. लॉगिंग और मॉनिटरिंग

अपने API रूट्स के प्रदर्शन को ट्रैक करने के लिए लॉगिंग और मॉनिटरिंग लागू करें। महत्वपूर्ण घटनाओं, जैसे त्रुटियों, चेतावनियों और सफल अनुरोधों को लॉग करें। अनुरोध विलंबता, त्रुटि दर और संसाधन उपयोग जैसे मेट्रिक्स को ट्रैक करने के लिए मॉनिटरिंग टूल का उपयोग करें। Sentry, Datadog या New Relic जैसी सेवाएं सहायक हो सकती हैं।

डिप्लॉयमेंट संबंधी विचार

Next.js API रूट्स को सर्वरलेस प्लेटफॉर्म पर डिप्लॉय करने के लिए डिज़ाइन किया गया है। लोकप्रिय डिप्लॉयमेंट विकल्पों में शामिल हैं:

API रूट्स के साथ अपने Next.js एप्लिकेशन को डिप्लॉय करते समय, सुनिश्चित करें कि आपके एनवायरनमेंट वेरिएबल्स डिप्लॉयमेंट प्लेटफॉर्म पर ठीक से कॉन्फ़िगर किए गए हैं। साथ ही, सर्वरलेस फ़ंक्शंस के कोल्ड स्टार्ट समय पर भी विचार करें, जो आपके API रूट्स के प्रारंभिक प्रतिक्रिया समय को प्रभावित कर सकता है। अपने कोड को अनुकूलित करना और प्रोविजन्ड कॉन्करेंसी जैसी तकनीकों का उपयोग करना कोल्ड स्टार्ट समस्याओं को कम करने में मदद कर सकता है।

निष्कर्ष

Next.js API रूट्स React के साथ फुल-स्टैक एप्लिकेशन बनाने का एक शक्तिशाली और सुविधाजनक तरीका प्रदान करते हैं। सर्वरलेस फ़ंक्शंस का लाभ उठाकर, आप डेवलपमेंट को सरल बना सकते हैं, परिचालन लागत को कम कर सकते हैं, और एप्लिकेशन के प्रदर्शन में सुधार कर सकते हैं। इस लेख में उल्लिखित सर्वोत्तम प्रथाओं का पालन करके, आप मजबूत और रखरखाव योग्य API रूट्स बना सकते हैं जो आपके Next.js एप्लिकेशन को शक्ति प्रदान करते हैं।

चाहे आप एक साधारण संपर्क फ़ॉर्म बना रहे हों या एक जटिल ई-कॉमर्स प्लेटफ़ॉर्म, Next.js API रूट्स आपकी विकास प्रक्रिया को सुव्यवस्थित करने और असाधारण उपयोगकर्ता अनुभव प्रदान करने में आपकी मदद कर सकते हैं।

अधिक जानें