🟢
Veb-sayt

Node.js va Express bilan REST API quriş: amaliy qöllanma

02.02.2026
← Barça maqolalar

Zamonaviy veb-ilovalar deyarli har doim ikki qismdan iborat: foydalanuvçi köradigan frontend va ma'lumotlarni boşqaradigan backend. Uşbu ikki qismni bir-biriga boğlovçi köprik aynan REST API hisoblanadi. Node.js va uning ustida qurilgan Express frameworki bugungi kunda backend dasturlaş uçun eng ommabop tanlovlardan biriga aylangan, çunki ular soddaligi, tezligi va ulkan ekotizimi bilan ajralib turadi. Uşbu maqolada biz noldan boşlab töliq işlaydigan REST API qurişni, route va middleware tuşunçalarini, CRUD amallarini, xatolarni boşqariş, validatsiya va autentifikatsiyani amaliy kod misollari bilan örganib çiqamiz.

Express nima va nega u kerak

Express — bu Node.js uçun minimal va moslaşuvçan web framework bölib, u HTTP sörovlarini qabul qiliş va javob qaytariş jarayonini ança soddalaştiradi. Node.js ning özida ham veb-server yaratiş mumkin, biroq bunda har bir sörovni qölda tahlil qiliş, URL'larni soliştiriş va javob sarlavhalarini sozlaş kabi murakkab işlarni özingiz bajarişingizga töğri keladi. Express esa bu murakkablikni yaşirib, sizga route'lar, middleware va qulay yordamçi metodlar orqali işlaş imkonini beradi. Aynan şu sababli minglab kompaniyalar va startaplar öz API'larini Express asosida quradilar, çunki u kam kod yozib köp natijaga erişiş imkonini beradi.

Loyihani sozlaş va birinçi server

Işni boşlaş uçun avvalo kompyuteringizda Node.js örnatilgan bölişi kerak. Keyin yangi loyiha papkasini yaratib, undagi paketlarni boşqariş uçun npm yordamida loyihani işga tuşiramiz va Express kutubxonasini örnatamiz. Quyidagi buyruqlar loyihaning asosiy tuzilmasini tayyorlaydi va birinçi işga tuşiriladigan serverni yozişga zamin yaratadi.

mkdir my-api && cd my-api
npm init -y
npm install express

Endi loyiha ildizida index.js faylini yaratamiz va eng oddiy serverni yozamiz. Bu server faqat bitta manzilga sörov kelganda javob qaytaradi, biroq u bizning butun API'mizning poydevori bölib xizmat qiladi. Diqqat qiling, server ma'lum bir portni tinglaydi va u işga tuşganda konsolga xabar çiqaradi.

const express = require('express');
const app = express();

app.use(express.json());

app.get('/', (req, res) => {
  res.json({ message: 'API ishlayapti' });
});

const PORT = 3000;
app.listen(PORT, () => {
  console.log(`Server ${PORT}-portda ishga tushdi`);
});

Route'lar va CRUD endpointlari

REST API ning asosiy ğoyasi resurslar bilan işlaşdir, masalan foydalanuvçilar yoki maqolalar. Har bir resurs ustida törtta asosiy amal bajariladi: yaratiş, öqiş, yangilaş va öçiriş, ya'ni CRUD. Bu amallar mos ravişda POST, GET, PUT va DELETE HTTP metodlari orqali ifodalanadi. Quyidagi misolda biz oddiy massiv körinişidagi vaqtinçalik ma'lumotlar ombori bilan işlovçi töliq CRUD endpointlarini körib çiqamiz.

let users = [{ id: 1, name: 'Ali' }];

app.get('/users', (req, res) => {
  res.json(users);
});

app.get('/users/:id', (req, res) => {
  const user = users.find(u => u.id === Number(req.params.id));
  if (!user) return res.status(404).json({ error: 'Topilmadi' });
  res.json(user);
});

app.post('/users', (req, res) => {
  const user = { id: Date.now(), name: req.body.name };
  users.push(user);
  res.status(201).json(user);
});

app.delete('/users/:id', (req, res) => {
  users = users.filter(u => u.id !== Number(req.params.id));
  res.status(204).end();
});

Uşbu kodda req.params orqali URL'dagi dinamik qismlarni, req.body orqali esa sörov tanasidagi JSON ma'lumotlarni öqiymiz. Javob qaytarişda HTTP holat kodlarini töğri tanlaş juda muhim: yangi resurs yaratilganda 201, muvaffaqiyatli öçirişda 204, topilmaganda esa 404 kodi qaytariladi. Bu kodlar API mijozlariga nima sodir bölganini aniq tuşuntiradi.

Middleware tuşunçasi

Middleware — bu sörov serverga kelib, javob qaytgunça bölgan oraliqda işlaydigan funksiyalardir. Ular orqali siz sörovlarni jurnalga yoziş, autentifikatsiyani tekşiriş, ma'lumotlarni qayta işlaş yoki xatolarni uşlab qoliş kabi işlarni markazlaştirilgan tarzda bajarişingiz mumkin. Yuqorida işlatgan express.json() ham aslida middleware bölib, u kelayotgan JSON tanasini avtomatik ravişda obyektga aylantiradi. Öz middleware'ingizni yoziş ham juda oson.

function logger(req, res, next) {
  console.log(`${req.method} ${req.url}`);
  next();
}

app.use(logger);

E'tibor bering, har bir middleware oxirida next() funksiyasini çaqiriş kerak, aks holda sörov keyingi bosqiçga ötmay osilib qoladi. Bu mexanizm Express'ni juda kuçli qiladi, çunki siz murakkab mantiqni kiçik va qayta işlatiladigan bölaklarga ajratişingiz mumkin.

Xatolarni boşqariş va validatsiya

Işonçli API yaratişda eng köp e'tibordan çetda qoladigan, biroq eng muhim jihatlardan biri bu xatolarni töğri boşqarişdir. Foydalanuvçi notöğri ma'lumot yuborişi, mavjud bölmagan resursni söraşi yoki serverda kutilmagan muammo yuzaga kelişi mumkin. Bunday holatlarda API tuşunarli xato xabari va töğri holat kodini qaytarişi şart. Express'da maxsus xato boşqaruvçi middleware törtta argument qabul qiladi va u barça route'lardan keyin joylaştiriladi.

app.post('/users', (req, res, next) => {
  if (!req.body.name) {
    return res.status(400).json({ error: 'Ism majburiy' });
  }
  next();
});

app.use((err, req, res, next) => {
  console.error(err);
  res.status(500).json({ error: 'Server xatosi' });
});

Validatsiya, ya'ni kiruvçi ma'lumotlarni tekşiriş, xavfsizlik nuqtai nazaridan ham nihoyatda zarur. Amaliyotda köpçilik dasturçilar bu vazifani qölda yoziş örniga maxsus kutubxonalardan, masalan Joi yoki express-validator'dan foydalanadilar, bu esa kodni toza va işonçli saqlaşga yordam beradi.

Ma'lumotlar bazasi va autentifikatsiya

Haqiqiy loyihalarda ma'lumotlar massivda emas, balki ma'lumotlar bazasida saqlanadi. Node.js MongoDB bilan Mongoose orqali yoki PostgreSQL bilan Prisma kabi vositalar orqali oson boğlanadi. Boğlaniş odatda ilova işga tuşişi bilan bir marta örnatiladi va keyin route'lar içida şu boğlaniş orqali sörovlar bajariladi. Autentifikatsiya esa köpinça JWT, ya'ni JSON Web Token texnologiyasi orqali amalga oşiriladi: foydalanuvçi tizimga kirganda unga maxsus token beriladi va keyingi sörovlarda şu token orqali uning kimligi tasdiqlanadi.

const jwt = require('jsonwebtoken');

function auth(req, res, next) {
  const token = req.headers.authorization?.split(' ')[1];
  if (!token) return res.status(401).json({ error: 'Token yo\'q' });
  try {
    req.user = jwt.verify(token, process.env.SECRET);
    next();
  } catch {
    res.status(403).json({ error: 'Token noto\'g\'ri' });
  }
}

Eng yaxşi amaliyotlar

Professional darajadagi API yaratiş uçun bir neçta muhim qoidalarga amal qiliş kerak. Birinçidan, kodingizni mantiqiy qatlamlarga ajrating: route'lar, biznes mantiği va ma'lumotlar bilan işlaş alohida fayllarda turişi loyihani ösib borgani sayin boşqarişni osonlaştiradi. Ikkinçidan, maxfiy ma'lumotlarni, masalan ma'lumotlar bazasi parollari va token kalitlarini heç qaçon kodga töğridan-töğri yozmang, balki muhit özgaruvçilarida saqlang. Uçinçidan, API versiyalaşni joriy eting va doimiy ravişda sörovlar tezligini çeklaş kabi xavfsizlik çoralarini qöllang. Uşbu amaliyotlarga rioya qilsangiz, sizning API'ingiz nafaqat işlaydigan, balki haqiqiy yuklamaga doş beradigan işonçli tizimga aylanadi.

Öxşaş maqolalar

🧾 Onlayn dökon va fiskal çek: virtual kassa talablari 💻 IT kompaniya sayti: software house, autsorsing va developer servisi uçun strategiya 🌾 Qişloq xöjaligi va agrobiznes sayti: mahsulotlar katalogi va B2B sotuv 🧪 Tibbiy laboratoriya sayti: testlar katalogi, onlayn buyurtma va natija oliş
🌐 Til
🇺🇿 O⁠'zbek 🇺🇿 Özbek (yangi) ✓ 🇺🇿 Ўзбек 🇷🇺 Русский 🇬🇧 English