परिचय: JavaScript पर REST API — तेज़ और सरल
आधुनिक वेब डेवलपमेंट API के बिना अधूरा है। REST (Representational State Transfer) वेब सेवाएँ बनाने के लिए सबसे लोकप्रिय आर्किटेक्चरल शैली है। यदि आप अपने एप्लिकेशन के लिए जल्दी से बैकएंड बनाना चाहते हैं या सर्वर डेवलपमेंट की मूल बातें सीखना चाहते हैं, तो Node.js और Express आदर्श विकल्प हैं।
इस लेख में हम 30 मिनट में JavaScript पर एक पूर्ण REST API लिखेंगे। आप सीखेंगे कि सर्वर कैसे सेट करें, रूट्स (रूटिंग) को कैसे व्यवस्थित करें, CRUD ऑपरेशन (Create, Read, Update, Delete) को लागू करें और Postman की मदद से API का परीक्षण करें। कोई अतिरिक्त सिद्धांत नहीं — केवल अभ्यास। चलिए शुरू करते हैं!
1. वातावरण तैयार करना और निर्भरताएँ स्थापित करना
कोड लिखने से पहले, सुनिश्चित करें कि आपके कंप्यूटर पर Node.js (संस्करण 14 या उच्चतर) स्थापित है। इसे इस कमांड से जाँचा जा सकता है:
node -vnpm -vप्रोजेक्ट के लिए एक नया फ़ोल्डर बनाएँ और package.json को इनिशियलाइज़ करें:
mkdir my-rest-apicd my-rest-apinpm init -yअब Express स्थापित करें — Node.js के लिए एक न्यूनतम और लचीला फ्रेमवर्क। साथ ही JSON अनुरोधों को संसाधित करने के लिए body-parser स्थापित करें (Express के आधुनिक संस्करणों में यह अंतर्निहित है, लेकिन स्पष्टता के लिए हम इसे स्पष्ट रूप से जोड़ेंगे):
npm install express body-parserप्रोजेक्ट की संरचना सरल होगी:
app.js— मुख्य सर्वर फ़ाइलroutes/— रूट्स वाला फ़ोल्डरdata/— परीक्षण डेटा वाला फ़ोल्डर (डेटाबेस का अनुकरण)
2. Express पर बेसिक सर्वर बनाना
app.js फ़ाइल बनाएँ और निम्नलिखित कोड लिखें:
const express = require('express');const bodyParser = require('body-parser');const app = express();const PORT = 3000;
// JSON प्रोसेसिंग के लिए Middlewareapp.use(bodyParser.json());
// सरल परीक्षण रूटapp.get('/', (req, res) => { res.send('REST API काम कर रहा है!');});
// सर्वर शुरू करनाapp.listen(PORT, () => { console.log(`सर्वर http://localhost:${PORT} पर चल रहा है`);});node app.js कमांड से सर्वर शुरू करें और ब्राउज़र में http://localhost:3000 खोलें। आपको "REST API काम कर रहा है!" संदेश दिखना चाहिए। बधाई हो, आपने अभी-अभी Node.js पर अपना पहला वेब सर्वर बनाया है!
ध्यान दें: body-parser आने वाले डेटा को JSON प्रारूप में बदलता है, जो POST और PUT अनुरोधों के लिए आवश्यक है।
3. रूटिंग और CRUD ऑपरेशन का आयोजन
अब चलिए वास्तविक डेटा जोड़ते हैं। data फ़ोल्डर बनाएँ और उसके अंदर परीक्षण ऐरे के साथ items.js फ़ाइल बनाएँ:
const items = [ { id: 1, name: 'Node.js सीखें', completed: false }, { id: 2, name: 'API लिखें', completed: true }, { id: 3, name: 'लेख प्रकाशित करें', completed: false }];
module.exports = items;routes फ़ोल्डर बनाएँ और उसके अंदर items.js फ़ाइल बनाएँ। यहाँ हम कार्यों (to-do list) के साथ काम करने के लिए सभी रूट्स का वर्णन करेंगे:
const express = require('express');const router = express.Router();let items = require('../data/items');
// GET /api/items — सभी आइटम प्राप्त करेंrouter.get('/', (req, res) => { res.json(items);});
// GET /api/items/:id — ID द्वारा आइटम प्राप्त करेंrouter.get('/:id', (req, res) => { const id = parseInt(req.params.id); const item = items.find(i => i.id === id); if (!item) return res.status(404).json({ message: 'आइटम नहीं मिला' }); res.json(item);});
// POST /api/items — नया आइटम बनाएँrouter.post('/', (req, res) => { const newItem = { id: items.length + 1, name: req.body.name, completed: req.body.completed || false }; items.push(newItem); res.status(201).json(newItem);});
// PUT /api/items/:id — आइटम अपडेट करेंrouter.put('/:i